For Users of Heath and Zenith Computers 



Turbo Pascal: The 
New Basic Language? 

An M BASIC 
Simulation 

Rigging Up a ctrl-p 
for HDOS 


Upgrade the 
ZVM-134 Monitor 
to Display All 
the ’150’s Colors 

IBM Emulation 
With the 
UCI EasyPC 






Features 



It isn’t quite the arcade-game style of 
simulation used to train jet pilots. But 
it might help a student of physiology 
appreciate the regulation of blood 
flowing through the kidney. And it 
might help you write your own 
simulation. 




The Fifth International Heath/Zenith 
Users’ Group Conference attracted Hll 
users and Z240 users—and everyone in 
between. There were discussions of 
desktop publishing, artificial 
intelligence, and plans for the future. 
But there was still time to have fun, 
and maybe win a door prize. 


Turbo Pascal: The New Basic Language? 

Hugh Kenner 9 

Bye-bye BASIC. Pascal has been enjoying an increasing 
blaze of attention as a standard programming language. 
Borland International gave it a turbo boost in this race by 
releasing a fast compiler priced below $100. It’s available 
for CP/M, MS-DOS, and CP/M-86. Turbo Pascal just 
might become the standard microcomputer language of 
the 1990s. Should you be on the band wagon? 

IBM Emulation With the UCI EasyPC 

Wayne Rash, Jr. 17 

One way to get your Z100 to run software designed for the 
IBM Personal Computer is to plug in the three circuit 
boards of the UCI EasyPC. But how easy is that? How 
effective is the resulting hybrid? Are there any disad¬ 
vantages? Here are the answers from someone who’s also 
checked out the alternatives. 

The Eight-Bit World 

Walter J. Janotvski 23 

Here’s a quick look at a dozen independent vendors still 
supporting the H8 or the H/Z89-90. Their hardware and 
software products can give your old machine some new 
capabilities. 

Upgrade the ZVM-134 to Display 16 Colors 

William Gochee 27 

Rigging Up a CTRL-P for HDOS 

Ferruccio G. Barietta 33 

CP/M and MS-DOS allow you to send console output to 
the printer as well as to the screen simply by typing 
CTRL-P. Here’s how to add a similar feature to your HDOS 
system. It was developed for a printer with a parallel 
interface. But we’ve included tips for adapting it to an H8 
or H/Z89 with a serial printer port. 

Play Apples and Floors on Your ’100 

Robert E. Marler 41 

For the cost of 110 quarters you can have an arcade-style 
game for your 110 or 120. It substitutes the keypad for a 
joystick as you control Happy Harry in his continuing 
battle with the Big Mouth Meanies. 
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A C Utility that Does More than PRINT 

Anthony F. Herhst 43 

The MS-DOS PRINT utility has a lot of options, but line 
numbering isn’t among them. For that, we present clist2. 

It has a few options of its own, including altering the 
printer setup. 

Z100 Notebook 

William N. Locke 48 

BASIC, Logo, and C each have something to offer the 
Z100 user. Here’s a look at each, including two 
approaches to getting C to emulate one of the commands 
of GW BASIC. 

An MBASIC Simulation 

Robert W. Rasch 52 

Patching Word’s .PRN Files For More Printer 
Features 

Ken Daniel 59 

Here’s how to alter the printer configuration support files 
supplied with Microsoft Word. Doing so lets you fill in 
any gaps in Word’s support of the features of your printer. 


C Notes 

Joseph Katz 65 

Knowing a little bit about assembly language program¬ 
ming can make a big difference in how successful you are 
at programming in C. Here’s an extensive overview of the 
reasons and the alternatives—with some hints for further 
exploration. 
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TOZVM 134 




The Z140, Z150, and Z200 computers 
can support 16 colors, while the 
ZVM-134 monitor displays only eight. 
Fortunately, Zenith has just the circuit 
board to bridge the gap—if you know 
how to install it. Here are the details. 





















































The Editorial Eye 


IBM’s domination of the micro¬ 
computer marketplace lasted about 
five years. It began even before they 
delivered a single IBM Personal 
Computer. Many people interested in 
micros believed that IBM would sell a 
lot of whatever they attached to the 
IBM nameplate. Programmers saw 
an opportunity to make a lot of money 
selling software to the anticipated 
customer base of IBM Personal Com¬ 
puter users. Perhaps some of them 
regretted missing out on the lucrative 
market of Apple owners. They 
weren’t about to make the same 
mistake twice. 

So would-be developers of IBM-compatible hardware and software 
snatched up many of the first IBM Personal Computers to reach the stores. 
These rapid initial sales fueled the expectations of IBM success and drew even 
more independent support into the IBM marketplace. Companies already 
producing microcomputers soon rushed to jump on the band wagon of com¬ 
patibility with IBM. 

The sad result was that an entire industry was depending on the innovations 
of a single company. Microcomputer progress in the five years since IBM’s 
entry has been far less rapid than in the five previous years. One symptom of 
this is that virtually all the software currently available for the newest IBM 
micros will also run on the IBM Personal Computer. 

The domination of this industry by one company is based on three factors: 
the I, the B, and the M. Fortunately, some buyers are willing to look beyond 
the nameplate on a computer. Two major examples of this emerged in late 
February. The Internal Revenue Service awarded Zenith Data Systems a 
portable computer contract that had been widely reported to be destined for 
IBM. Zenith also won a contract for the Z200 series that was called the largest 
microcomputer contract ever awarded by the U.S. government. 

The March 5 issue of Buss that carried the news of the two contracts also 
contained my reaction: “I have a persistent hunch that IBM won’t be domi¬ 
nating the microcomputer marketplace nearly so much in the future.” Indeed, 
IBM’s market share is now put at below 50%. 

In September, Compaq Computer Corp. announced an innovation outside 
the shadow of IBM. Compaq’s Deskpro 386 is designed around Intel’s 80386 
32-bit microprocessor—a chip not yet used in an IBM product. Other hard¬ 
ware vendors are also working on 80386 machines without waiting for IBM to 
announce one. 

Now that awe of IBM is no longer blocking progress in microcomputers, 
perhaps we can put some more fun into this industry. It doesn’t take much of a 
computer to replace a calculator, a typewriter, or a card file. The real challenge 
is to replace a piano or a box of crayons. 

Speaking of fun, I’m looking forward to returning to the Disneyland Hotel 
for the 1986 Western Regional Heath/Zenith Users’ Group Conference. It’s 
scheduled to run from Friday afternoon on November 14th through noon on 
Sunday, November 16th. Admission to the discussions and vendor exhibits is 
set at $10. It’s $28 complete with the Saturday dinner and drawing for prizes. 
(Western Regional HUG Conference, 1555 North Orange Grove Ave., 
Pomona, CA 91767.) 
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LAPTOP 
COMPUTER 
SPECIAL 

Personal Advanced Laptop 
Computer C/IAA 

for Only 

Includes six Microsoft programs in ROM 
FREE $200 Merchandise Certificate with purchase 
Includes FREE carrying case! 

The ZP-150 is a 71/2 lb. briefcase-size computer that goes with you 
anywhere. It includes a modem, calendar, and alarm, plus Microsoft 
WORKS, WORD, MULTIPLAN, BASIC, and more all built into ROM. 
You even get an additional 32K of memory, a printer adaptor cable, 
and FREE file transfer software worth $147. And with your mer¬ 
chandise certificate, you can get up to $200 worth of products 
FREE when you visit our store! 

BONUS Now with FREE 32K memory, printer cable & file transfer software. 


Zenith ZF-118-42 Personal Computer 
with FREE Monitor Oo AA 

Only 

A Low-Profile computer with • MS-DOS operating sys¬ 
tem • 256K RAM • two 5.25" drives • 8 MHz operation • 

monochrome and color graphics capability 
• FREE monochrome monitor 


Low Profile H-101-20 
Personal Computer Kit 6 aaa 

Only W D«F«F 

Includes MS-DOS operating system and 1 floppy drive. 
Monitor and second disk drive optional. 


HZC-247 


HEWLETT 

PACKARD 


Tcm/th I data 

| systems 

AUTHORIZED DEALER 

LEASING AVAILABLE FOR 
YOUR BUSINESS NEEDS 


Phone orders accepted. 

Prices good through January 15,1987. 

Call 616-982-3614 for store locations or 
consult your Heathkit Catalog. 

Your TOTAL SERVICE computer center 
' Service • Support • Software • Accessories • User Training • Competitive Prices 
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Letters 


Is the ’200 compatible with 
the 100? 

In the Match-April issue, in his article 
“A Quick Look at the Z200,” Commander 
Robert J. Gray included an insert (page 
31) in which he referred to the Z248 
as the “Eight-in-One.” Commander Gray 
stated that the name apparently came 
from the Z248’s ability to be compatible 
with a variety of PCs, including the Z100 
by means of the Z319 board. 

I am now rather confused. In a recent 
conversation with Zenith’s technical ser¬ 
vices, I was informed that they were un¬ 
aware of any plans to make the Z248 
compatible with the Z100. In fact, they 
doubted it would be possible considering 
the vastly different architecture of the 
two machines. The Z319 board referred 
to was designed to provide Z100 compat¬ 
ibility to the Z158. 

I would be very interested in knowing 
who is right, Commander Gray or ZDS. 
Will the Z248 provide compatibility with 
the Z100 by means of the Z319 board, or 
will it not? I have delayed upgrading my 
computer lab on the basis of Commander 
Gray’s article, pending the someday 
release of the Z248. 

Dr. Dean F. Keeley 
Professor of Chemistry 
The University of Southwestern 
Louisiana 
Lafayette, Louisiana 

The Z4i9 board enables the Z248 to be 
compatible with the 100. In order to win 
the government contract. Zenith had to 
make provisions to ensure that it would 
be compatible. At present, though, the 
board is apparently only being actively 
marketed to users covered by the govern¬ 
ment contract. 

A 148 expansion box? 

I recently received my first issue of 
Sextant (September-October). If it is an 
indication of things to come, I will be a 
long-time subscriber. 

I read the article on gate arrays with 
particular interest since I have a Z148. 
One point that aroused my curiosity was 
the comments about the development of 
an expansion box, on page 12. I currently 
have a two-drive, 640K color system. In 
the future, I would like to expand my 
computer with a 20-meg hard disk, a 
clock/calendar, and a modem. An EGA 
board is also a remote possibility. Once 
you’re hooked, it appears that there is no 
limit but budget on items you would like 
to have, and that is why I am interested in 
getting more information on the availabil¬ 
ity of an expansion box. 

I believe that companies such as First 
Capitol Computer already offer a 


daughterboard that would allow adding 
the hard disk, clock/calendar, and 
modem; however, I am concerned about 
the life expectancy of my power supply. 
Also, no other cards could be added. I 
know you are probably thinking, “Why 
didn’t he buy a T58 to begin with?”, and 
my only answer is that this is my first 
computer and, as such, initial cost was a 
major influence. 

Any additional help on this subject 
would be greatly appreciated. 

Bert Dirschell 
Decatur, IL 

Fractal program modifications 

I read with pleasure Ed Byrnes’ article, 
“BASIC Fractals,” in the July-August 
issue of Sextant. Well done. He’s tackled 
a complicated subject and made it under¬ 
standable to the layperson. 

I’ve enclosed some modifications to 
Ed’s program which allow it to be com¬ 
piled. [See Listing A.] They also reduce 
disk storage space by two-thirds (55K vs. 
186K). 

Instead of saving three color planes of 
62K each, the program saves color value 
and pixel location data but only for those 
pixel points where color changes occur 
(lines 270-290). This stored information is 
subsequently used by the LINE command 
to display the image (lines 330-350). 

I’ve also made some other minor 


modifications to speed up the program: 
Line 15—Defines as integers the loop 
and count variables. 

Line 70—Automatically displays image of 
a previously stored picture (Row >1). 
Lines 190-250—Original program forced 
a ten-line comparison. Mod allows 
RETURN as soon as correct value of V is 
determined, and requires only one com¬ 
parison per line. 

The compiled program runs 20-30 
times faster and allows more pictures on 
each disk. Hope this helps. 

George Holt 

Nashua, NH 

Pointers on Word 

Freddy Sweet’s recent review of 
Microsoft Word [in Sextant issue #23] 
was thoughtful and accurately reflected 
the product. A couple of pointers might 
be useful to him and to other Zenith users 
of Word. I also have a couple of observa¬ 
tions. 

Although Sweet was for the most part 
extremely positive about Word 2, he 
objected to the slowness with which 
Word saves documents and performs cer¬ 
tain other tasks. Even with version 2, 
Word will speed up many of its operations 
if you use a computer with 320K of avail¬ 
able RAM. It represents a significant im¬ 
provement over 256K. But the better 
solution is to upgrade to version 3, which 


10 CLS:PRINT"Ed Byrnes’s Fractal Image Generator as modified by G. HoltPRINT: ’ 2 
100 Version 
15 DEFINT M, N, C, V 

£0 ON ERROR GOTO 370:FILES"????????.FRA" 

30 PRINT"7he Picture Files above are presently on this drive. !l 
40 INPUT"Narne this Fractal (Do not use . or extensiori) " FRfl" 

50 INPUT"LAMBDA AND SIDE (use range of 0 to -2,and 0 to -1.25, and 1)";ACORNER,B 
CORNER,SIDE:GAPX=SIDE/840:GAPY=SI DE/225 

60 INPUT"Start at Row: (Row 1 if new image, £24 if completed image.>";M1 
70 CLS:IF Ml>1 THEN GOSUB 330:IF Ml=££4 THEN END 
90 FOR M=M1 TO £24:FOR N=1 TO 639 

100 AC=(N*GAPX)+ACORNER:BC=(M*GAPY)+BCORNER:GOSUB 160 
110 AZ=0:BZ=0 

120 ZZ$=INKEYS:IF ZZ*="Z" THEN GOSUB £70:END 
130 IF SIZESQ=> 4 THEN PSET(N,M),V 
140 C=0:SIZESO=0 

150 NEXT:NEXT:LOCATE l,l,l:GOSUB £70:END 

160 AX =AZ•"'•£—BZ'"£+AC : BX=£*AZ*-BZ + BC : AZ=AX : BZ=BX : SI ZESQ=AX’'£+BX‘'£ 

170 IF SIZESQ=> 4 THEN GOSUB 190:RETURN 

160 C=C+1:IF C <100 THEN 160 ELSE RETURN 

190 IF 0 50 THEN V=5:RETURN 

£00 IF 0 25 THEN V=7:RETURN 

210 IF 0 15 THEN V=4:RETURN 

212 IF 0 6 THEN V=6: RETURN 

£14 IF 0 7 THEN V=£: RETURN 

£16 IF 0 5 THEN V=1 : RETURN 

£20 IF 0 3 THEN V=3: RETURN 

230 IF 0 2 THEN V=1 : RETURN 

240 IF Ol THEN V=3: RETURN 

£50 IF 0=0 THEN V=l: RETURN 

270 Ml=M-1:OPEN A$ FOR OUTPUT AS #1:F0R M=0 TO Ml:V=POINT(0,M> 

£80 FOR N=1 TO 639:IF V<>POINT(N, M)THEN PRINT #1,N-1;V; :V=PQINT(N,M) 

£90 NEXT:PRINT#1,N-l;V;:NEXT:CLOSE 

300 PRINT"NAME: ’ ";A$;"’ ":PR INT"LAMBDA:";ACORNER;"’ ";BCORNER 

310 PRINT"SIDEj";SIDE:PRINT"ROW:";Ml:PRINT"(Write":PRINT"this":PRINT"down 1 )" 

320 RETURN 

330 OPEN A* FOR INPUT AS #1:F0R M=0 TO M1:PSET(0,M) 

340 INPUT #1,N,V:LINE-(N,M) , V:IF N<>639 THEN 340 
350 NEXT:CLOSE:RETURN 

j 70 IF ERR=53 THEN PRINT"No Picture files found!":RESUME 30 


Listing A. (See “Fractal program modifications,” above.) 
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How People With Common 
Interests find an interesting 
Common Ground. 


Presenting CompuServe Forums. 
Where people from all over get 
together, without even leaving 
home. 

Now thanks to CompuServe 
Forums, computer owners are sharing 
common interests by talking to each other 
through their computer keyboards. Soft¬ 
ware users , computer enthusiasts, ham 
operators , french cooks , Gre Gghters, 
science Gction lovers and other special 
interest groups are already in touch, 
online. 

Because when you subscribe to 
CompuServe, you’re able to reach people 
who want to talk about the things you do. 
As many people as you like. For as long 
as you like. Whenever you wish. 

Join a conversation already in 


progress or start one on your own. Ask 
questions. And get answers. 

All it takes is a modem, most any 
personal computer and CompuServe. 

Forum members across the country 
are as close as a local phone call. 

You can go online with just a local 
call in most major metropolitan areas. And 
normal usage fees for weekday nights and 
weekends are just IOC a minute 

Of special interest to all Forum 
participants is software that’s FREE 
for the taking. 

Public domain software. For all 
sorts of activities, from games to business 
programs. And it’s just as easy to copy a 
piece of software as it is to participate in 
a Forum. 


Become a CompuServe subscriber and 
get a $25 Usage Credit to start you off. 

Becoming a subscriber is as easy as 
contacting your local computer dealer. Or 
you can call us and order direct. Suggested 
retail price is $39.95. 

And if you’d want more information 
about CompuServe, we’ll be happy to send 
you a free brochure. Because with all that 
CompuServe offers—we think it’s in your 
best interest. 

CompuServe* 

Information Services, RO. Box 20212, 

5000 Arlington Centre Blvd., Columbus, OH 43220 

800 - 848-8199 

In Ohio, call 614-457-0802 
An H&R Block Company 
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performs far faster than any previous ver¬ 
sion of Word. This speed-up isn’t limited 
to disk operations. Scrolling is fast, too. 

Sweet lamented that there isn’t a way 
to perform a series of operating-system 
operations in the middle of a Word edit¬ 
ing session without returning to Word 
each time. “This may be something that is 
possible, but I have not figured out how to 
accomplish it,” he said. 

The way to accomplish it is to use the 
Library Run command and type the word 
COMMAND, then press Enter. This 
returns you to the operating system, 
where you may perform any number of 
DOS operations or run other programs, 
while Word is stored—along with your 
active document—in RAM. When you 
want to return to Word, type EXIT at the 
DOS prompt, and press Enter. This tech¬ 
nique is fully covered in my book, Word 
Processing Power with Microsoft Word 
[Microsoft Press]. 

Sweet praised Word’s abilities with 
multiple windows, but objected mildly to 
the window borders. Of course, without 
borders you couldn’t have multiple 
windows. 

Sweet wondered about how you might 
embed printer control codes in a Word 
document. You shouldn’t have to, be¬ 
cause Word now comes with support for 
more than 100 printers, and a program 
(makeprd) is included to let you create 
printer-description files for any printer 
that is not supported by Microsoft. How¬ 
ever, you can add control codes to Word. 


There are a couple of ways to do this. One 
is to use the Print File command to print a 
copy of a document to disk, and then load 
the disk file into Word (or into a window 
of Word). You then can add control codes 
(using the Alt-numeric keypad tech¬ 
nique), and later print the edited file with 
the DOS print command. 

And then there is the question of pagi¬ 
nation. I agree with Sweet that Word 
would be improved if it showed you the 
present line number and page number at 
all times, without requiring you to repagi¬ 
nate the document with the Print Repagi¬ 
nate command. I’m told by the men and 
women who wrote Word that there were 
some tough design trade-offs that led to 
the decision not to include this feature. 
Essentially, many of Word’s other impres¬ 
sive features—such as the ability to han¬ 
dle lots of different type sizes and fonts on 
the same page (and even on the same 
line), and the ability to rapidly reformat 
large sections of a document—would 
have been slowed down dramatically or 
made impossible if line and page 
numbers were displayed, basically, Word 
permits page formatting to be extremely 
complex—so complex that keeping a 
document paginated on a moment-to- 
moment basis would use a great deal of 
computing power. On an 8088-based ma¬ 
chine, Word’s performance would slow 
dramatically. 

So, a different approach was taken. In¬ 
stead, Microsoft made Word smart 
enough that there isn’t a lot of need to 


paginate on an on-going basis. For in¬ 
stance, through the use of the paragraph 
attributes “keep together” and “keep 
follow,” you can control which paragraphs 
print together on the same page. The idea 
is that you can tell Word what rules you 
follow when deciding what appears on a 
page, and then let Word worry about 
following the rules for you when it actual¬ 
ly lays out the pages during pagination. 

I hope these pointers are useful, and I 
look forward to your next review of 
Word—a review of version 3. 

Peter Rinearson 
Seattle, Washington 

Can I keep my 8" drives? 

I read, with much interest, the article 
“Add More 514" Drives to Your Z100” by 
William N. Tavolga in your July-August 
issue. 

I am in a position where I would very 
much like to add more drives (514") onto 
my system. I currently operate with the 
two internal 514" drives and two 8" drives. 

I have a friend that ran into a software 
problem and I offered to help. The prob¬ 
lem started when he copied the software 
so that I could try and solve his problem 
at home, on my time and machine. As it 
turned out, his machine, which uses 
CP/M and seemed to indicate that it was 
40-track/48-tpi, was in fact 80-track/96- 
tpi. I was unable to help him, and I cannot 
run some very interesting software I 
would like to own because of the 96 tpi. 

Mr. Tavolga’s article states that “If you 


$749 20 Meg 

2/100 Winchester 

LINDLEY SYSTEMS announces a significant reduction 
in our hard drive pricing. Here are our new 
prices: 

Internal External 
10 Meg $ 699 $ 899 

20 Meg $ 749 $ 949 

These systems include: 

The Konan DGC-2000 Controller 
A Seagate Winchester drive 
- Our Software Driver 
Appropriate Cables 

KONAN Controller 

The Konan controller board is a single slot S-100 
card which will connect with one or two ST-506 
compatible hard drives. Because this board 
contains the latest technology interface, it uses 
much less space and power than previous 
controllers. 

Note that with the Konan board, there are no traces 
to cut, no ROMs to replace. Just plug in the board 
and go. Whether you decide to install the drive 


internal or external, the only tool you need is a 
screwdriver. (Internally mounted drive units 
simply replace one of your half-height floppy 
drives.) 

WINCHESTER DRIVE 

uur winchester systems include either the ST-213 
(10 Megabyte) or ST-225 (20 Megabyte) drive units 
from Seagate. 

DEVICE DRIVER 

Our new device driver supports drive sizes up to 
256 Megabytes, with up to 8 partitions, each up to 
32 Megabytes. You can use one or two drives (up to 
512 Mb on line!) The driver operates under both 
MS-DOS 2 and 3. 

Our hard disk systems are shipped with two versions 
of the driver software: one for native Z-100 mode, 
and one for use with the Gemini PC emulator. Any 
partition can be mounted either under Z-100 mode, 
Gemini mode, or both. Thus, you can put Z-100 
programs in one partition; Gemini programs in 
another; and your data, shared between both modes, 
in a third. 

LARGE CAPACITY 

Please call for pricing and availability of large 
capacity drives. We are seeking (no pun intended) 
the best value! 

LINDLEY SYSTEMS 21 Hancock Street Bedford, MA 01730 
(617) 275-6821 
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follow my instructions, you will eliminate 
the support for the two 8" drives and 
substitute two additional 5 1 // drives.” Is 
there any way that one can get around this 
situation? 

I would like to keep my system the way 
it is and have at least one 5 1 //, 96-tpi 
drive. Can this be done at all, or am 
I relegated to my present configuration 
only? 

Any help or information you can give or 
forward to me will be greatly appreciated. 

Charles A. Bergey 
Churchville, PA 

The specified changes to the DEFDSK 
and BDSKTB files sacrificed 8" drives and 
retained support for hard disks. Since 
your system doesn’t use hard disks, you 
can sacrifice them and retain 8” drive 
support code instead. 

Family tree? 

Just received my first issue of Sextant. I 
read it cover to cover! A superb 
magazine. 

Have you ever considered a “family 
tree” of the Heath/Zenith computers 
showing the evolution? 

Keep up the fine work. 

Stan Laine 
APO New York 09742 

Speed up fractal programs 

I want to commend Mr. Locke for his 
excellent work with the “Z100 Notebook” 
and congratulate you for finding him. His 
information in issue #23 on the use of the 
second page of video is worth a year’s 
subscription. I have long suspected that 
page flipping like this is possible, but the 
information as to how is well buried in the 
Technical Reference manual, and hours 
of study yielded no clue. Now about inter¬ 
lace mode. . . . 

Mr. Byrnes’ article [in Sextant #23] 
was also of great interest to me, since I 
sell a similar program, Mandel, also 
based on Dewdney’s Scientific American 
article. The article gives an excellent ex¬ 
position of the issues involved, and a good 
starter program to generate these fascina¬ 
ting pictures. It takes Byrnes 40 lines of 
BASIC code to do what I do in some 
4,000! The kinds of reasons for the 
difference—interface and optimiza¬ 
tions—may give your readers some ideas 
of ways the core program presented in the 
article might be extended. 

The program given in your pages does 
the essentials; the rest is mostly decora¬ 
tion: help screens, specification of param¬ 
eters by moving a frame over a picture as 
an alternative to numeric entry, and 
dynamic assignment of colors based on a 
preliminary scan of the plane. Other con¬ 
venience features include the ability to 
view previously drawn pictures, and an 
automatic mode which searches for in¬ 
complete pictures and works on them 
unattended. 

Instead of writing a special viewing and 
color-changing program, the output can 
be in a format suitable for processing by a 


drawing program, which will allow any 
kind of alteration. In my case, I generate 
in the format of Dale Wilson’s Palette 
program—which also results in disk 
storage requirements which are a fraction 
of those of BSAVE. 

No amount of optimization is going to 
make a program like this run fast on a 
microcomputer, but quite a bit can be 
achieved: 

1. (Obvious) If you have BASCOM, compile 
the program once it works, and achieve 
an order of magnitude speed improve¬ 
ment. A full-screen drawing will be 
produced in hours instead of days. 

2. Fine-tune the code, especially in the 
inner loop. Byrnes uses [in lines 160- 
180]: 

AX = AZ A 2-BZ A 2 + AC: BX = 2*AZ*BZ + BC: 
AZ = AX: BZ = BX: SIZESQ = AX A 2+BX A 2 
IF SIZESQ => 4 THEN <done> 

COUNT = COUNT + 1: 

IF COUNT < 100 THEN <line> 

<done> 

which can be rewritten as: 


FOR COUNT = 0 TO 99: 

AZ = AX*AX: BZ = BX*BX: 

IF AZ + BZ > SIZESQ THEN <done> 

CZ = AX*BX: AX = AZ-BZ + AC: 

BX = CZ + CZ + BC: 

NEXT COUNT 
<done>. 

The rewrite uses a FOR loop, which is 
faster than a “manual” loop. It avoids re¬ 
dundant calculation of the squared term. 
(Notice that the calculations for the 
squared terms for AZ and BX in iteration 
n +1 were already performed in iteration 
n.) But the main improvement achieved 
is in reduction of number of operations. 
In efficiency, it is conservative to count a 
multiply (*) as equivalent to 5 additions, 
and an exponentiation ( A ) as equivalent 
to 100 additions. In these terms, the orig¬ 
inal contains 4*100 + 2*5 + 4 = 414 
additions, the rewrite contains contains 
0*100 + 3*5 4- 5 = 20 additions, or 5% 
of the time. For code that will be execut¬ 
ed up to 640*225*100 = 14,400,000 
(Continued on page 92) 
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Turbo Pascal: The New 
Basic Language? 

Oh, Turbo! It’s fast and cheap. What more could you want? Will it become the 
new standard? 


Hugh Kenner 


John Kemeny, co-inventor of the 
BASIC language, says flatly that were 
he forced to choose between Microsoft 
BASIC and Turbo Pascal his choice would 
be Turbo Pascal. (See Computer Lan¬ 
guage, October 1985, Doug Millison’s 
interview, “BASIC’s Kemeny and Kurtz 
Discuss the Language Today.”) 

True, he and his collaborator Tom 
Kurtz are currently bad-mouthing Micro¬ 
soft’s “Street BASIC”—the better to 
promote what they call True BASIC—but 
his choice of a plausible rival to Microsoft 
BASIC fits a trend True BASIC at present 
does not seem to be riding. 

BASIC had the advantage of being 
there early. Back when small computers 
were programmed by flipping switches, 
BASIC was the only high-level language 
worth considering. (FORTRAN would 
have been ridiculous for someone’s first 
language.) It was then that Bill Gates, 
soon to found Microsoft, wrote a won- 
drously compact implementation that 
freed hobbyists from bother with in¬ 
dividual bits and this or that port on the 
central processing unit (CPU). 

Soon every microcomputer from Apple 
to Zenith came with either Microsoft 
BASIC or something similar; some, like 
the IBM Personal Computer, even have it 
hard-wired in. 

Afterthoughts gradually enlarged 
Gates’s BASIC puppy into a mongrel wolf¬ 
hound among languages: big, shaggy, 
tractable in the right hands, lovable for 
simple errands, but archaic and hard to 
housebreak. 

For the primitive genes never did get 
eased out the way Kemeny and Kurtz now 
say they should have been. Thus, refer¬ 
ence by numbered lines reflects a line- 
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at Johns Hopkins University in 
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appear in such publications as 
Harper’s and The National Review. He 
is the author of several books, 
including the Heath/Zenith Z100 User’s 
Guide. 


oriented time when editors too worked 
only line-by-line, like CP/M’s silly ED. 

Between the line being typed and 
some future line, the ready link was the 
infamous GOTO. WHILE . . . WEND looks 
like what it is, a late afterthought; if lines 
must still be numbered, you may as well 
GOTO them. Nothing’s easier, unless 
perhaps cooking spaghetti. 

Lately, the computer magazines have 
seemed less sure than they used to be that 
BASIC is the micro Esperanto. More and 
more listings in Turbo Pascal appear. A 
feature article in the November 1985 
issue of Byte described five small libraries 

The more you use 
Turbo Pascal, 
the less appeal 
BASIC has. 


of Turbo Pascal utilities. (See “Program¬ 
ming Project: Extending Turbo Pascal,” 
by Bruce Webster.) Space limitations 
prevented printing the entire listings, but 
they were offered for downloading via 
modem from Byte’s own BYTEnet. (The 
sound of Byte’s throat clearing? No one 
doubts how much that can portend.) 

Stores began to display language books 
that teach not simply Pascal but explicitly 
Turbo Pascal; simultaneously, magazines 
displayed ads from software peddlers 
with Turbo Pascal enhancements to offer. 
(Darryl Rubin reviewed a number of 
them in the November 1985 issue of 
Computer Language. See “Thirty Add-on 
Tools for Turbo Pascal.”) 

Can Microsoft BASIC’s long arthritic 
reign as the top micro language at last be 
facing sunset? 

Not impossibly. At Borland Interna¬ 
tional, a company formed around a go-go 
anarchist named Philippe Kahn, they 
have gotten rid of just about every real 
drawback to using Pascal as one’s 
standard language. The more you use it, 


the less appeal BASIC has. 

Borland’s Pascal, moreover, is cheap, 
and can be had for most current operat¬ 
ing systems. It’s available for 8-bit use 
under CP/M-80; and for 16-bit users, 
it runs under CP/M-86 and the Micro¬ 
soft Disk Operating System (MS-DOS). 
Though Apple does seem left out, hard¬ 
core Apple fans can always add a CP/M 
board, as serious ones have likely done 
anyway. 

Pascal , pre-Turbo 

Those drawbacks to using Pascal, pre- 
Turbo? A brief list: 

(1) Primitive input/output (I/O) facilities. 

Niklaus Wirth devised Pascal as a 

teaching language back in mainframe 
days. Programs and data went in on decks 
of punched cards, results came out on 
line-printers, and that was exactly all that 
the language provided for. Micros, with 
interactivity on keyboards and screens, 
required added facilities. So did comfort¬ 
able handling of files and strings. 

In consequence, every micro-Pascal 
you could buy differed from Standard 
Pascal just in the delicate area where the 
language was prescribing how a user 
might interact with a program. The 
Standard (stated, 1974, by Jensen and 
Wirth; redefined, 1983, by the Interna¬ 
tional Standards Organization) was lacon¬ 
ic wherever it wasn’t being prescriptive; 
so, each implementation enhanced I/O 
its own way. 

(2) Non-standardization was therefore in¬ 
evitable. 

For practical purposes there was no 
standard micro Pascal, not the way 
Microsoft’s became the standard BASIC. 
UCSD Pascal came closest. But UCSD— 
again, something from a mainframe en¬ 
vironment—is also a prime example of 
(next slide, please)— 

(3) Cumbersome implementation. 

Pascal, as you probably know, is a com¬ 
piled language. To produce a runnable 
version, the words you type get “com¬ 
piled” (translated) into bits and bytes your 
processor can understand. That is not 
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unlike running assembly-language code 
through the assembler. If you’ve tried 
that, you know the steps it can require, 
and the slowness to produce a workable 
version of your program. And should the 
compiler report even a trivial error, 
you’ve no remedy save to write off lost 
minutes and start over. You could get 
three small BASIC programs debugged in 
the time it took to get one Pascal program 
barely running. Then it likely couldn’t 
run on any machine but your own. Non¬ 
portable. 

(4) Non-portability came in two flavors, 
both distasteful. 

(A) Source code written in a non- 
standardized language was only guaran¬ 
teed to run on the kind of compiler it was 
written for. UCSD Pascal addressed that 
by padding its shoulders, deepening its 
voice, and claiming to be the standard. It 
even sported its private operating sys¬ 
tem, which meant that when you were in 
UCSD you were out of anything else. 

(B) Machine code compiled for a 
specific machine was unlikely to run 
properly on any other. UCSD’s answer to 
that was pseudo-code; p-code generated 
by the compiler can be run on any 
machine with a p-code interpreter. But 
an interpreter points you back toward 
BASIC’s slowness in actually running a 
program. The interpreter wastes time 
generating the machine code anew, not 
only during every program run but dur¬ 
ing every iteration of every loop. So why 
not write in BASIC anyway? 

No wonder Pascal was a little preserve 
for fanatics. Many a Pascal dialect became 
known as a Grouchy BASIC. 

These and other annoyances Turbo 
Pascal has addressed, with a success some 
400,000 purchasers have ratified. The 
biggest single customer is rumored to be 
IBM, where the gnomes use Turbo in- 
house—while out on the street the flacks 
are selling Microsoft Pascal, costly and for 
everyday purposes clunky. 

And the most surprising single custom¬ 
er? The “ETH,” the Eidgenossische Tech- 
nische Hochschule in Zurich, Einstein’s 
alma mater and Niklaus Wirth’s hangout: 
the very Vatican of Pascal, where if 
anywhere you’d expect austere deference 
to the Standard, and they’re using, yes, 
Turbo Pascal. Now that is infiltration. 
(For this and much more on current 
events at the ETH, see Jerry Pournelle’s 
“Chaos Manor’’ column in the December 
1985 issue of Byte.) 

A non-Standard standard 

At the heart of Turbo is a basically full 
Standard Pascal. There are, however, 
three or four small modifications to be 
noted by those of you used to Standard 
Pascal: you don’t PACK and UNPACK be¬ 
cause the compiler knows when to do it 
for you; you don’t GET or PUT because 
Turbo’s I/O makes those maneuvers 
needless; PAGE is not implemented; a 
GOTO cannot leave the current block; and 


you can’t pass procedures or functions as 
parameters. (And when did you last 
need to?) 

Now here let me step carefully. Turbo 
Pascal, like Microsoft BASIC, is coherent 
and self-contained. But as D. E. Cortesi 
points out, its deviations from the Stan¬ 
dard do reduce the inventory of outside 
programs that can be imported into 
Turbo; and “changing the logic of an im¬ 
ported program . . . because of a stupid 
omission from a compiler is not a good 
use of time.” (See D. E. Cortesi, “Dr. 
Dobb s Clinic,” in Dr. Dobb’s Journal, 
July 1985.) 

GET and PUT, as Cortesi points out, 
have their rationale. (Incidentally, he 
gives the clearest account I’ve seen of the 
way Wirth meant us to imagine files.) 
One can always do without them. But for 
a few Cadillac situations—a few —they 
come in handy, and a program that uses 
them isn’t portable without tricky re¬ 
writing. 

You feel the omission of GET and PUT in 
the very first modules of Kernighan and 
Plauger’s Software Tools , which can’t be 
Turbo’d as given. Since Turbo Pascal 
“seems destined to dominate the micro 
world,” Cortesi thinks all its omissions 
from the Standard should be repaired. 
I’m persuaded, and I hope Mr. Kahn is 
listening. 

But on to what Turbo offers at present. 
It reads identifiers of up to 127 charac¬ 
ters, looking not just at the first six or 
eight but at every one. Without needing 
any extended-precision directives, Turbo 
accords up to 11 significant digits to “real” 
numbers (IE-38 to IE+ 38). With the 
version of Turbo for MS-DOS machines 
with the 8087 math chip, you get 15 digits 
in the range 4.19E-307 to 1.67E + 308. 

Integers may be decimal or hexadec¬ 
imal; a “$” prefix denotes the latter. Being 
stored in two bytes, integers are limited 
(as in most micro Pascals) to plus or minus 
32,767. Turbo also provides the BYTE type 
as a subset (0 to 255) of INTEGER, using 
only one byte instead of two. 

(Memory now being cheap, I trust a 
future version will extend the integer 
limits; Turbo’s most serious flaw is 
permitting integer overflow with no 
warning.) 

Enhancements to the Standard include 
strings, which can be up to 255 characters 
long, and a tidy set of functions for deal¬ 
ing with them. The long list of enhance¬ 
ments runs from the convenient to the 
esoteric. You get a random-number gen¬ 
erator and ways to position the cursor. 
You also get logical AND, OR, XOR, and 
bit-shift operators. There’s also a 
FILLCHAR procedure that will stuff any 
character you want into every byte of any 
specified area of memory. (That’s great 
for clearing character arrays.) And there 
are dozens more. 

All that for under $70, non-copy- 
protected, is already much and yet is only 
the start. Turbo Pascal surrounds it with 


its own text editor for typing in your code, 
triggers plain-English error messages 
that locate the error’s location right in 
your typing, and earns its name with a 
compiler that runs like a scorched chee¬ 
tah. Typically, compilation takes about 10 
seconds for a long program, the kind that 
had old Pascal hands brewing coffee 
while they waited. 

For a speed comparison, take a look at 
Lucidata Pascal, which I described in Sex¬ 
tant #6, Summer 1983. (See “Pascal Elu¬ 
cidated.”) Reported to compile much 
faster than Microsoft’s, Lucidata takes 
just two minutes to compile to p-code the 
word-counting program I gave in that 
review. Add 11 seconds to produce stand¬ 
alone machine code, which can then 
count a 2,300-word file in 210 seconds. 
That is on my 2-megahertz H89 (under 
the Heath Disk Operating System). 

In Turbo Pascal 2.0 on the same 
machine (under CP/M), the equivalent 
program compiles in 1.8 seconds, straight 
to a machine code that counts the same 
file in 55 seconds. If you want compilation 
to disk, add 2 more seconds. Whew! 
Turbo! 

Inside Turbo 

At the operating system prompt, the 
command TURBO loads the package. (Ver¬ 
sion 2.0 takes up 35 kilobytes running 
under MS-DOS, 28K under CP/M-80). 
Then you are asked to accept or reject 
explicit error messages (as distinguished 
from numbered ones to be looked up in 
the manual). Accepting them adds a 2K 
overlay. 

In MS-DOS, “A” (for Active) now lets 
you change the active directory. In any 
version, “L” will change the Logged disk. 
“W” (for Working) lets you specify a file 
name, old or new. And “E” switches on 
the Editor. Each of these options works 
quick as a wink. 

The editor in its default state acts like a 
subset of WordStar, with its CTRL-E/s/d/x 
diamond to move the cursor; on the 
Z100, but not on the H89, the arrow keys 
will come up doing the same. 

If you don’t want the editor’s default 
configuration, you can change each and 
every command by running through a 
TINST procedure; it asks you, for some 45 
editing commands, to accept the default 
or strike the keys you’d prefer in its place. 

Naturally you’ll be guided by the habits 
you’ve formed on your favorite editor. I 
didn’t configure my ’89 Turbo to resemble 
PIE —but only because I started with 
TINST Version 1.0, which was distinctly 
buggy. By the time I had the amended 
2.0, I’d grown used to that WordStar 
subset. 

Warning: If you do run TINST, work 
from a well pondered list. It won’t com¬ 
plain about an inadvertent duplicate com¬ 
mand till you’ve finished and must go 
through all 45 steps yet again. That is 
a bore. 

However you configure the editor, “E” 
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takes you into it for entering Pascal text. 

That’s a pleasant job. The indentations 
that make Pascal readable are semi¬ 
automatic. Blocks can be marked for 
moving, deleting, or transferring to disk 
files. At a place where you may want a 
pre-stored block, you summon it from the 
disk. On exiting the editor, “R” (Run) will 
compile the program, then run it. (Out¬ 
side the editor, “R” gives run without 
compile.) 

If the program is short, compile is so 
quick you might as well be running a 
program under the BASIC interpreter; I 
can show you useful programs that com¬ 
pile in one second. If it’s long, allow a few 
seconds—likely fewer than 10—for com¬ 
pile. 

Rarely, compilation can seem rather 
slow, especially if you have a great many 
lines like 

TEMP := Y + 0.23428 - (0.77786 * SIN(X) + 
0.897816245); 

Here, the compiler appears to exhaust 
whatever repertory of shortcuts it em¬ 
ploys elsewhere. All it can do with those 
arbitrary numbers is shove them into 
memory byte by byte. One of my pro¬ 
grams, not only long but a-bristle with 
some 300 lines of that intractable sort, 
detains the version 2.0 compiler for 40 
seconds. (The recent version 3.1 slices 40 
to 23, its typical rate of speed-up.) 

Debugging 

If you’ve made a syntactic error, compi¬ 
lation halts with a message like 
ERROR 5: ')' EXPECTED. PRESS <ESC> 

Do what it says and you are back in the 
editor, with the cursor positioned just 
after where “)” should be. Insert it, exit, 
re-run. 

Debugging BASIC isn’t much faster. It 
is usually slower, thanks to the frequent 
difficulty of identifying BASIC bugs in the 
first place. 

One complaint against Pascal is that it 
slows you down by requiring you to pre¬ 
declare all variables. That, however, 
doesn’t take stock of perhaps the most 
frequent BASIC bug: the finger-slip that 
enters a variable as COST at one place but 
CIST at another. The BASIC interpreter 
meekly assumes that CIST is a brand-new 


variable, leaving you to wonder how your 
COST values went wrong. Hence, despite 
recent hype, my lack of interest in True 
BASIC. 

A Pascal compiler, alerted to the vari¬ 
able COST, will complain should it ever 
meet CIST, just like a watch dog that 
knows the authorized guests. That is one 
thing I gladly pay a compiler to do, and 
I’m unsympathetic to complaints that 
pre-declaration and type-checking make 
Pascal hard to use. 

A word of commendation, by the way, 
for the error messages. Upon stumbling 
at the initial bug, many compilers (e.g., 
the excellent C/80 from The Software 
Toolworks) stumble on clear to the end in 
hopeless confusion—en route discover¬ 
ing 23 more “errors” which are nothing 
but misreadings of all the code that 
follows one real mistake. 

Turbo’s compiler stops dead in its 
tracks on finding cause for one complaint. 
It may not always stop where the trouble 
is; it stops where it detects trouble, for 
instance at the unmatched END; some 
lines after a missing BEGIN. But I’ve sel¬ 
dom had trouble making out what the real 
difficulty was, and I’m always grateful for 
the economy of action. 

It's all in memory 

Like the Turbo system itself and the 
source code, the machine code we’ve 
been discussing is all in memory, volatile 
but quick. That’s one reason the compiler 
is so fast: it isn’t fooling with disks. 
Should we want a .COM file for future 
execution from our disk or from someone 
else’s, a keypress or two will cause the 
compiled program to be sent to disk. 

The compiler, however, is so fast that 
one routinely uses it like an interpreter. 
Save disk space by disking only the .PAS 
version; when you want to run a program, 
call TURBO, w(orkfile), c(ompile), R(un). 
Since Turbo (under MS-DOS) loads in 
about one second, the entire sequence 
can be literally faster than ZBASIC . . . 
LOAD . . . RUN. (That’s quite apart from 
the fact that the program itself likely runs 
up to 20 times faster.) 

The machine-language program you 
run never needs to go on disk unless 


Books on Turbo Pascal 

Douglas S. Stivison, Introduc¬ 
tion to Turbo Pascal 1985: 268 pp.: 
Sybex Inc. $14.95. (The work of an 
enthusiast, and the best treatment 
of Turbo’s I/O peculiarities.) 

Steve Wood, Using Turbo Pascal 
1986: 304 pp.: McGraw-Hill. 

$19.95. (Covers version 3, and 
very thorough on everything ex¬ 
cept machine-language.) 

Jeff Duntemann, Complete 
Turbo Pascal, 1986: 464 pp.: Scott 
Foresman. $19.95. (Precedes ver¬ 
sion 3, hence already a smidgen 
dated. Superb on machine-lan¬ 
guage interfacing. Be warned that 
the program listings contain 
numerous typos.) 


(1) you want to save it as a stand-alone, or 

(2) it’s too long to coexist in memory with 
the compiler itself. 

That brings up the question of com¬ 
pactness. A Turbo Pascal program with 
nothing in it at all save BEGIN and END. 
will compile to some 8K (CP/M-80) or 9K 
(MS-DOS); we can deduce that compila¬ 
tion begins by scooping up the entire 
function library: plus, minus, sine, co¬ 
sine, you name it. But compilation there¬ 
after is thrifty, adding bytes to the .COM 
file at a lower rate than words get added to 
the source file. Typical figures are 13K of 
.COM for 8K of source code, 14K of .COM 
for 10K of source code. 

And remember that Pascal, unlike 
BASIC, keeps comments (REMarks) out of 
its running code altogether. You can be 
prodigal with observations on what-goes- 
on-here and not worry about bloating the 
.COM version. 

The upper limit is 64K of .COM file. In 
the unlikely event of needing more, you 
can either CHAIN sections together or use 
overlays that at run-time replace no 
longer needed blocks of code with follow¬ 
ups. Turbo’s overlay-handling is neat and 
automatic. 
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Since the compiler doesn’t link togeth¬ 
er modules of machine code to produce a 
larger program, it can’t accept machine- 
code files from a library. But it can in¬ 
clude any number of Pascal-code files. 
In the main program, an instruction like 
this 

{$1 ROUTINES. PAS} 

will cause the whole of a file called 
ROUTINES.PAS, which could be any collec¬ 
tion of useful stuff, to be read from 
the disk and inserted at compile-time. 
Amenities I keep in such files include 
25th-line commands (TO25, FROM25) to 
save me looking up those non-memorable 
Escape sequences. 

Compilation goes optimally when 
memory can contain, all at once, your 
source code, the compiler, and the 
machine code the compiler generates. 
Lots of MS-DOS memory is a help. That’s 
especially true with Turbo version 3, 
where the sky seems to be the limit. (That 
was not always the case with version 2; for 
instance, it limited stack plus heap to just 
over 200K no matter how much RAM you 
offered it.) 

The 64K of CP/M-80 can be a tight 
limit. If something has to give, you have 
either or both of two main resources: 
(1) rid memory of machine code by com¬ 
piling to disk; (2) break up the source 
code so only part of it is resident at a time. 

An easy way to do the latter is chop the 
program in two. The editor can mark the 
second half as a block and write it to disk 
as PARTTWO.PAS. You then delete the 
block. The cursor is now at the end of the 
remnant, Part One, where you add the 
command 
{$1 PARTTWO. PAS} 

Compile, and PARTTWO will be picked up 
and appended. 

Enhancements? Portability? 

But we re ignoring the single greatest 
strength of Turbo Pascal, its immense 
parade of enhancements to Wirth’s Stan¬ 
dard Pascal. These begin, naturally, with 
the I/O provisions—for historical 
reasons, the diceyest area of the 
Standard. 

Just there, unfortunately, the Turbo 
manual commences to grunt like a dehy¬ 
drated camel. A good recourse is Douglas 
S. Stivison’s Introduction to Turbo 
Pascal. It’s explicitly written both to pen¬ 
etrate opacities in the manual and to ease 
the frustrations you’d have in coping with 
Turbo via any of the Pascal books (even 
my favorite, Cooper & Clancy’s Oh! 
Pascal!) that presuppose some other 
dialect. 

But no book is perfect; Stivison for 
instance is misleading on what the {C + } 
compiler directive does. In that condition 
(the default), CTRL-C will halt the 
program—not, as he implies, at any time, 
but only if it’s the user’s response to a 
request for input. 

But I mentioned enhancements. What 
about portability? 

True, all these years the best argument 


for cleaving to the Standard has been that 
only standard code is sure to be trans¬ 
portable. But in practice, as we’ve seen, 
there has been no standard code. The 
Turbo gamble is that Turbo will become 
the de facto standard micro Pascal. That 
gamble seems well on the way to being 
won. 

Indeed, more than one writer has 
noted that you can think of Turbo Pascal 
less as a Pascal enhancement than as a 
new language based on Pascal. That’s the 
premise of Stivison’s book, which talks of 
Pascal as though Borland International 
had created the entire language yes¬ 
terday. 

The current Microsoft BASIC in the 
same way is a new language based on 
what Kemeny and Kurtz devised at 
Dartmouth an aeon ago. It annoys K & K 
that most people seem to think Microsoft 
invented it. Yet for many thousands of 
micro users, invent BASIC is exactly what 
Microsoft did—one reason K &: K are now 
widely heard of. Microsoft established a 
dialect intrinsic with an editor and a 
growing set of enhancements, exactly 
what the Borland folk have done for 
Pascal. 

In doing so, they’ve boldly scrapped all 
thought of portability, save between 
versions of Turbo Pascal itself. What you 
write for Turbo Pascal probably will not 
run on Lucidata Pascal, nor on the Berke¬ 
ley Pascal that comes on many Unix 
systems, nor on Microsoft’s Pascal either. 

Even when most of the code is identi¬ 
cal, the I/O portions probably will not be. 
Stivison is bold enough to call Turbo’s I/O 
tools “unequalled by any other PC-based 
language . . . only equalled by assembly 
language itself.” These I/O tools include, 
should you ever need them, techniques 
to address ports and handle interrupts. 

Turbo will let you incorporate assembly 
code, too, should assembly language be 
your simplest recourse; though each new 
release of operating-system-specific en¬ 
hancements makes such a situation less 
probable. Version 3.1 can even pick up 
parameters from the entry command 
line. 

Some valuable idiosyncrasies 

Stumbling on Turbo’s idiosyncrasies 
one by one as you collide with their 
divergences from the Standard, you can 
think them maddeningly whimsical. But 
surveyed as a whole, they are wonderfully 
coherent. 

The input routines accept data from a 
keyboard, from a text file (a file free-form 
all the way to the end-of-file marker), or 
from a more structured file, as of records 
of uniform length. (In the latter case, a 
function called FILE SIZE will tell you how 
many components are in the file. One 
program I’ve written relies on being able 
to deduce the current year with 
FILESIZE.) Users can even answer a y/n 
question with a single character and 
never touch RETURN. 

Output too can go to the screen, to a 


disk file, or to any hardware device: a 
printer, a modem, a robot. 

All this is better explained by Stivison 
than by the manual. It depends on 
Turbo’s having defined “logical”—phan¬ 
tom—devices for all input/output to 
come from or go to; you can match them 
to corresponding real-world devices at 
will. So, in Turbo 
READ (CH); 
is the same as 
READ (INPUT, CH); 

and means “Read into the buffer the char¬ 
acter that has just come from the key¬ 
board.” Here, “the buffer” means a place 
where we can make changes before things 
get irrevocable—as they will once we hit 
RETURN. But 
READ (KBD, CH); 

means “Recognize only a character from 
the keyboard, and send it directly to 
headquarters.” That’s the form you’d use 
if the program’s next line was checking 
for “y” or “n”— RETURN isn’t needed. 

Likewise, 

WRITE (CH); 
is short for 
WRITE (OUTPUT, CH); 

and sends a character to the screen, the 
default output; whereas 
WRITE (LST, CH); 

sends the character directly to the 
printer. Though close to the Standard, 
that’s all subtly unlike it; for tricky cases, 
see Stivison. 

Strings (another weak area of the 
Standard, which expects you to concoct 
them from arrays) are nicely handled, too. 
Thus, you could declare a variable, 
TEXTLINE : STRING[80]; 
to hold up to 80 characters. 

A Turbo string resembles an array in 
being accessible via subscripts, and the 
number of characters actually present 
will sit up front, in TEXTLINE[0]. 
(TEXTLINE [0] is in non-printing hexadec¬ 
imal code. We can access it, however, 
with LENGTH(TEXTLINE).) 

But with strings you can do jobs for 
which arrays are clumsy. You can insert or 
delete characters anywhere; you can con¬ 
catenate strings, match patterns within 
them, extract substrings. It is no longer 
true that only BASIC has a real string¬ 
handling capability, and the Turbo Pascal 
commands seem less crabbed. 

Here is BASIC’s way of exhibiting a 
substring: 

10 A$="THIS IS A STRING" 

20 PRINT MID$(A$,6,4) 

That prints 4 characters starting at posi¬ 
tion 6: “is a”. 

And here is the Turbo Pascal equiva¬ 
lent, using the string called TEXTLINE: 
TEXTLINE := 'THIS IS A STRING'; 

WRITE (COPY (TEXTLINE, 6,4)); 

Turbo’s “Copy” function extracts what 
BASIC calls the MlDstring. To change 
textline’s contents to THIS IS QUITE A 
STRING, the command would be simply 
INSERT (' QUITE', TEXTLINE, 8); 

And there, I don’t know of a BASIC 
equivalent. 
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Apart from the fact that their lengths 
can vary dynamically, strings differ from 
arrays in one radical respect. You can 
assign characters sequentially to a string’s 
cells as you would to an array: 
TEXTLINE[K] := CH 

where CH has just been read from a file, 
and K is an incrementing counter. 

But if you assign characters sequential¬ 
ly, the string’s length remains officially 
zero, even though the characters are 
somehow “in” it. Other string functions 
then detect a zero presence and decline 
to work. You can concatenate two or three 
strings that were filled in that way, and 
end up with exactly nothing, even though 
it’s still possible to access the parent 
components the way you would an array. 
As arrays they may seem stuffed, but 
they’re nonexistent as strings. 

The right way to put single characters 
into a string is with INSERT: 

INSERT (CH, TEXTLINE, K) 

The manual’s failure to mention this 


detail may spell trouble for programmers 
used to austere Pascals, where you im¬ 
provised “strings” from retyped arrays 
and could fill them only by incremental 
assignment. Turbo’s enhanced version is 
far more convenient, but use it the way 
the book says. 

. . . and other enhancements 

Of many other enhancements, I’ll cite 
only the error-checking facility IORESULT, 
which turns off the normal type-checking 
abort and lets you write code like this: 
REPEAT 

WRITE ('WIDTH OF LEFT MARGIN? '); 
{$1-} READLN (MARGIN) {$1 + }; 

OK := IORESULT = 0; 

IF NOT OK THEN 

WRITELN ('DIGITS ONLY!') 

UNTIL OK; 

Here, OK has been declared as a 
BOOLEAN, and MARGIN as an INTEGER. 

Now suppose a careless user, meaning 
to set the left margin to 5, has hit “t” 


instead. Normally Pascal’s type-check¬ 
ing, on detecting a CHAR where it ex¬ 
pected an INTEGER, would abort the 
program in a way not at all user friendly. 
But {$1-} substitutes for the guillotine the 
function called IORESULT, which is 0 when 
all is well. If IORESULT isn’t 0, we’re not 
OK; the DIGITS ONLY! message flashes, and 
the prompt repeats. Otherwise, our 
number is accepted and the program goes 
on. I call that programmer friendly. 

As Turbo Pascal has expanded through 
versions 2 and 3, its facilities for dealing 
with the operating system, notably with 
MS-DOS, have been progressively en¬ 
hanced. Unfortunately, dealing with the 
operating system remains Turbo’s most 
poorly documented area; it’s scamped in 
the manual, and skirted by both Stivison 
and his rival Steve Wood (Using Turbo 
Pascal). Here, the one resource is Jeff 
Duntemann’s Complete Turbo Pascal , 
with its long and valuable chapter on 
“Low-Level Machine Hooks.” 


Announcing 

Perks"-PC 


Now the Perks desktop utility is 
available for both the Z-100 
series and the Z-100 PC series 
computers as well as compatible 
computer systems. Perks-PC 
includes all Perks version 2 
features with command and 
screen formats identical to 
Z-100 Perks version 2. 


0* Calculator 
0* ASCII Table 
0* Notepad w/Variable 
size buffer (to 64K) 
0* Perpetual Calendar 
0* Appointment Calendar 
0* Context Sensitive Help 



Shown above is an actual photo of Perks in operation, with Lotus 1-2-3 in the background. 
The main menu and windows for the notepad, calculator, ASCII table, calendar and card file 
modules are visible. 


0* Cut/Paste 
0* Dialer 
0* Typewriter 
0* DOS Functions 
0* Alarm timers (8) 
0* Screen Saver 
0* Import/Export 


0* Removable w/o rebooting 
0* Runs with MS-DOS 
versions 1, 2 & 3 

0* Modem w/XMODEM file Xfer 
0* NOT copy protected 
0* Multi-Key ISAM Card File 
0* Small Size (under 8OK) 


Both Perks and Perks-PC are priced at $69.95 each* Telephone credit 
card orders (VISA and MasterCard) are now accepted without a prior 
signed license agreement. 

BARRY A. WATZMAN Microcomputer Systems & Consulting 

560 Sunset Road « Benton Harbor, Michigan 49022-7142 • (616) 925-3136 


Perks is a trademark of Barry Watzman. 


*Plus $4.00 for S&H, Michigan Residents add 4% sales tax also. 
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Despite Duntemann’s numerous ex¬ 
ample programs, however, there’s still 
room for an Advanced Turbo Pascal hand¬ 
book. In both the CP/M and MS-DOS 
versions of Turbo, for instance, memory 
is directly addressable via a built-in array 
called MEMARRAY. And under MS-DOS, 
you can place an integer value anywhere 
in memory with a MEMW statement. Like 
BASIC’s PEEK and POKE? Yes; but we re 
not told how to use it; MEMW isn’t even in 
the manual’s index. 

Here and elsewhere Borland’s pro¬ 
grammers seem to have outrun the 
manual writers so far that the two camps 
have lost touch utterly. 

For despite its documentation, Turbo 
will do wondrous things. The following, 
for instance, will paint the screen of the 
Z100 green in a flash: 

PROCEDURE GREENBACK; 

BEGIN 

PORT[216] := 120 + 256 * PORT[217]; 

FILLCHAR (MEM[$E000:128], 

MAXINT + 14000,255); 

PORTW[256] := 248 + 256 * PORT[217] 
END; 

What that does is get into video memory, 
then back out again, having while in there 
reached the “green” plane (hex E000, 
which in Turbospeak is $E000) and then 
filled it (fillchar) with “255” (11111111 
binary). 

Users of the Z150 can revel in a set of 
Turbo Pascal graphics excelling those of 
Z-BASIC. Much is incorporated in ver¬ 
sion 2 and later; much more is included in 


a supplementary package called the 
Turbo Graphix Toolbox. The like could be 
written for the Z100 if Turbo’s in¬ 
structions were a little more lucid. 

Though the Turbo Graphix manual 
more than once alludes to a Z100 version, 
that seems to have died on the vine. 
Cottage industry, as usual, to the rescue. 
Chaos Computers of Woodbridge, Vir¬ 
ginia, offers a ZGraphix disk for $29.95. 
From it you can modify the IBM version 
of Turbo Graphix so the Z100 will run it. 
During my sporadic tinkering, it’s run 
superbly. 

My point remains: the software can 
perform whatever you might want. The 
trick, once you’re past most Pascal hand¬ 
books, is to find out how. 

I don’t mean to leave the impression 
that the manual (over 300 pages, well 
printed and bound) is some sort of disas¬ 
ter. It is not. It is simply uneven. Useful 
items can lie in the manual unindexed 
and unnoticed; not even Stivison or 
Duntemann seems to have spotted the 
single line of type that says Turbo con¬ 
tains Pi predefined to 11 digits. 

Also, the manual has many hurried 
spots, apt to occur just where some inter¬ 
esting extension is being described. The 
assumption seems to be that “experi¬ 
enced programmers” will understand by 
osmosis, while the less adept won’t want 
the feature anyway. 

A great deal better is the manual for 
Borland’s Turbo DataBase Toolbox— 
chiefly, complex tree-management and 


sort routines, complete with source code 
on the disk. If you’re learning the 
language, Turbo Tutor (disk with book) is 
well worth getting. It’s informal and clear. 

The DataBase Toolbox, and further 
complements I haven’t tried, indicate just 
how well Turbo Pascal is doing. So does 
the fact that other companies are starting 
to advertise support packages for Turbo. 

My guess is that Turbo Pascal will be 
the standard micro language of the 1990s. 
No reason not to start enjoying it now. 

Ordering Information 

Turbo Pascal, version 3, for CP/M-80, 
$69.95; for MS-DOS and CP/M-86 
(includes BCD real numbers and 8087 
support), $99.95; Turbo Tutor, $34.95; 
Turbo DataBase Toolbox, $54.95; Turbo 
Graphix Toolbox, $54.95. 

Borland International 
4585 Scotts Valley Drive 
Scotts Valley, CA 95066 
800/255-8008 

ZGraphix (for the Z100), $29.95. 

Chaos Computers 
PO. Box 2106 
Woodbridge, VA 22193 
703/590-3360 

Bruce Webster’s Turbo libraries are: 
USERIQLIB, INTEGERS.LIB, STRINGS.LIB, 
STRUCT. LIB, and LINKED. LIB. 

Program listings may be downloaded 
via BYTEnet Listings at 617/861-9764. A 




ZMFIOOcl: 768KOn 
Old Motherboard 



ZCLK: On Line 
Date and Time 



Field-Proven, 
Thousands Sold 


Order Direct from FBE or 
See Your Heath/Zenith Dealer. 

Quantity Discounts Available. 
Dealer Inquiries Invited. 
UPS/APO/FPO Shipping Included. 
Literature Available. 

VISA or MasterCard accepted. 


The new and improved ZMFlOOa™ 
modification package lets you plug 
industry standard 256K RAM chips 
into your "old" motherboard Z-100™ 
computer. Up to 768K (27 RAM chips) 
without using an S-100 bus card slot! 
Maintains fully compatible memory 
maps so that all software will run. 
Usable only on part number 85-2653-1 
motherboard (assembly part number 
181-4917 or less)! 

Installation of the ZMFlOOa™ 
package is a simple, plug-in job 
requiring no soldering or trace cutting 
and only partial disassembly of the 
computer. The memory chip pin-ones 
are connected together by a plug-in bus 
bar. There are no permanent changes 
to the motherboard. 

The ZMFlOOa™ is a professional 
quality circuit board supplied with 
complete instructions and all required 
materials, except memory chips. It is 
compatible with the popular PC emulators 
and with 8MHZ speed modules. 

$65 Each 


The ZCLK™ is a calendar/clock 
module for the Z100™ series of 
computers. It is supplied with 
Z-DOS™/MS™-DOS software to auto¬ 
matically set the system time and date 
on bootup. Quartz crystal controlled 
with a fine tuning adjustment for 
optimum accuracy. An on-board 
Lithium battery maintains timekeeping 
during power-off periods. 

The ZCLK™ installs directly on the 
motherboard and does not use an S-100 
bus expansion card slot. The simple, 
plug-in installation takes just a few 
minutes to complete and does not 
permanently alter the computer. 

Electrically, the ZCLK™ installs on 
the printer side of the Z-100™ printer 
interface chip (U114). It does not inter¬ 
fere with printer operation and works 
fine with 8MHz speed modules. 

A special model of the ZCLK™ is 
required for use with either the 
Gemini® PC emulator card or the 
EasyPC™ emulators. Inquire for details 
and cost. 

$89 Each. 



FBE Research Company, Inc. 

PO. Box 68234 
Seattle, WA 98168 
(206) 246-9815 

ZCLK and ZMFlOOa are trademarks of FBE 
Research Company Inc. CP/M is a trademark of 
Digital Research Inc. MS is a trademark of Microsoft 
Corporation. Z-100 amd Z-DOS are trademarks of 
Zenith Data Systems. Gemini is a trademark of 
D.E.L. Professional Systems Inc. EasyPC is a 
trademark of UCI Corporation. 



Circle #142 on Reader Service Card 







I NEED SEXTANT! 

Start my subscrint;^ . 


Stan my subscription tight away! 

Entermy sub ^.Qn^r; 

° HiT* 0 '**™? «?7° t0 r Can ada) 

via a' ^r 5635 ^ SUrfa ~ "S^O 


Payment terms- 

ardSCva e bt ,check!m -'>- 

□ Bill me ars pa V ab l e on a (J.S. bank) 
D Char gemy: q Vis n 

Card# ° MaSterCar « 

Expiration date 

D°^bs^ppti ( ^ ,ta,r ^^ - ^^y^ofSextanf^ 
° ZDS Dealer S Reta ’' Store 

Heath sto.e O Othef 


Wfavi . D Hea th Store 5 ~ lend 

yOUrSUbscri ^n withlssue#2 ° ° ther 

#26 (January-February rs« 71 , 

~~ — ~~ — — ___ ___ S 2 ' 

I NEED SEXTANT! 

my subscription rightly. 

Enter m W...L . 


g’ter my subscription for- 

° f -So f r;f 4 29 97 9l ( /j34 50 to Canada) 

$27.00 overseas vesuri 5 f ° Canada -' 

va air mail) Surface mail; $35 . 00 


Payment terms- 

aS^^uraj*- 

D c, h :r y: Dviia dm — 


Expiration date 

□°^bs^dption )ta,r ^^^^^°P56xfant/ 
° ZDS Dealer S Retai 'Store 
D Heath s,„ re 


UH ~ 


S 25 -S 


When ^^'gp^ode e 20003 P ’ 



please 


POST AGE WILL BE PAID BY ADDRESSEE 


BUSS/SEXTANT 

716 E Street, S-E- 86Q 

Washington, DC 20U/' u 



Wh en n ' o “ U f !p “'e^ e e "oOT3 P 



please 


RUSINESS REPLY mail 

POST AGE WILL BE PAID BY ADDRESSEE 


BUSS/SEXTANT 
716 E Street, S^. 0 

Washington, DC 2uu 





Your computer can do a lot for 
you —if you have the support you 
need. One source of support 
thousands of Heath/Zenith users rely 
upon is Sextant magazine—the only 
independent magazine about your 
Heath/Zenith computer. Whether you 
use an H/Z150, H/Z100, H/Z89, or 
H8, you’ll find articles in every issue 
which apply to your system. 

You can explore MS-DOS, Z-DOS, 
CP/M, and HDOS in Sextant. 
Applications, programs, compatible 
hardware and software, and the 
latest developments in the 
Heath/Zenith community are among 
the topics covered in every issue of 
Sextant. Regular features include: 

“How-to” articles. Designed to help 
you enhance your system. Read how 
other users have altered their 
systems to suit their needs—and 
how you can too. 


YOU 

NEED 

SEXTANT 


Reviews of products from Zenith 
and independent suppliers. Written 
to help answer your questions about 
hardware and software purchases 
you’re considering. 

Short program listings. These 
include utility programs and games, 
which you can use immediately. 

Advertising by independent 
suppliers. You'll find many products 
advertised for your Heath/Zenith 
system that you just won’t find 
anywhere else. 

Coverage of community affairs. 

You’ll read about major events, 
conferences, and personalities in the 
Heath/Zenith user community, and 
what effect they could have on you. 

Don’t miss all the information 
packed into each issue of Sextant ! 



Start your subscription today! 
Call Toll Free: 
800/341-1522 

(DATATEL 800™, for orders only, Monday-Friday 
8 a.m.-9 p.m., and Saturday 9 a.m.-5 p.m., 

Eastern Time) 

-—- 

Or mail this coupon to: 

Sextant, Dept. S25 
716 E Street, S.E. 

Washington, DC 20003 

Please allow 6-8 weeks for delivery of your first issue. 


Money-Back Guarantee 

Your satisfaction with Sextant is completely guaranteed. 
If at any time you’re not completely satisfied, just let us 
know and your money will be refunded—even for the 
issues you’ve already received. 


I— -- - i 
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□ 12 issues for $29.91 ($34.50 to Canada) 

□ 6 issues for $14.97 ($17.25 to Canada; $21 
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□ Payment enclosed (checks must be in U.S. dollars 
payable on a U.S. bank) 

□ Bill me 
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Announcing 



* Runs on both the Z-100 and IBM-pc 
compatible computers. 

* Data transportability between Z-100 
and PC compatibles. 

* Cloth covered binder with slip case. 

* 130+ page manual includes tutorial, 
reference section, and index. 

* Undo feature allows quick correction 
of drawing errors. 

* Complete support for MS-DOS 2.xx path 
names and directories. 

* Magnify mode makes pixel-by-pixel 
editing easy. 

* Playback capability for slide shows 
and continuous demonstrations. 

* User defineable macros simplify 
repetitive drawing tasks. 

* Font editor included with package 
allows custom fonts of any size. 

* Guaranteed support for any dot 
matrix printer with bit-graphics 
capability. 




Available at Heath/Zenith Computer Centers, or Order Direct from. 


cm 


PAUL F. HERMAN 


Software Graphics Tools 
3620 Amazon Drive 
New Port Richey, FL 33553 


C.O.D. Orders 
Accepted 
813 * 376*5457 
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IBM Emulation With the 
UCI EasyPC 

The second in a series of articles examining three approaches to giving the Z100 
the option of running software designed for the IBM Personal Computer. 


Wayne Rash, Jr. 

The EasyPC board from UCI Corpora¬ 
tion and the Gemini board from Gemini 
Technology are the two leading products 
available for making your Z100 compati¬ 
ble with the IBM Personal Computer. 
Last issue, I looked at the Gemini board. 
(See “IBM Emulation with the Gemini 
Board.”) This issue, I’ll look at the 
EasyPC. 

(While these two are certainly the most 
prominent, they aren’t the only choices, 
of course. There is also the ZPC program 
offered by the national Heath Users’ 
Group. I hope to cover ZPC in a future 
issue of Sextant. For some background on 
the different strategies followed by these 
three products, see the comments ac¬ 
companying this article.) 

Examining the Gemini board and the 
EasyPC board, you’ll see they differ 
greatly—especially considering that they 
are both trying to start at the same begin¬ 
ning and arrive at the same goal. 

Compared with the Gemini board, the 
UCI EasyPC board is faster, and is harder 
to install. It probably has about the same 
level of IBM compatibility as the Gemini 
board, but incompatibilities show up in 
different ways. 

Regrettably, the UCI board may re¬ 
quire you to compromise on the way your 
Z100 performs in its native mode; it may 
also require you to make some tricky 
wiring changes. The most serious prob¬ 
lem is for owners of the “all-in-one” (or 
Z120) series. These users may have to 
make a few modifications to their com¬ 
puter before the UCI board will work 
properly with their hardware. 

The UCI EasyPC board consists of 
three circuit boards, a pair of integrated- 
circuit (IC) chips, a speaker assembly, 
and a wiring harness. Two of the circuit 
boards plug into slots provided by the 
ZlOO’s S-100 bus; the other board plugs 


Wayne Rash, Jr., is a consultant with 
American Management Systems in 
Arlington, Virginia. He’s also a 
freelance writer; his articles appear 
in publications such as Byte and 
PC Week. 


into IC sockets on the motherboard. The 
two S-100 boards are a video board and 
a disk-controller board. The UCI disk- 
controller board replaces the one your 
Z100 came with; that one will no longer 
be used. 

Compatibility 

In my tests, most software written for 
the IBM PC ran fine on the UCI board. 
For instance, there was not the decrease 
in speed that showed up on the Gemini. 
Moreover, screens appeared all at once, 
just as they do on IBM clones (rather than 

The most serious 
problem is for owners 
of the “all-in-one” 
(or Z120) series. 

being painted from top to bottom, as with 
the Gemini board). 

Not all was perfect, however. 

When I tested the board, software that 
required the serial input/output (I/O) 
port would not run on the UCI board 
without the purchase of a separate I/O 
board. Obviously, this meant that your 
communications software would not work 
without UCI’s I/O board. It also meant 
that you couldn’t use your serial printer, 
or your mouse, without one. 

Since I completed testing, however, 
UCI has introduced an I/O card which 
will allow programs using the serial ports 
to operate properly. 

The screen appearance, especially on 
the all-in-one Z120 computers, was a 
significant problem. Text was extremely 
dim, both in the Z100 mode and in the 
IBM mode. The only relief from this 
came when the screen was displaying 
characters in high intensity. The screen 
is so dim, in fact, that I’m writing this 
article on another computer so that I 
can see what I’m doing. I understand that 
this dimness can be overcome by remov¬ 
ing a resistor from the screen-brightness 


control. 

The EasyPC has a double-dot display 
mode, which UCI suggests for improved 
operation with color monitors. However, 
you have to solder a jumper between pins 
on an IC chip in order to change the 
display. 

Something that cannot be overcome is 
the tendency for the screen to “grow” by 
about ten percent after it has been dis¬ 
played for a minute or so. What happens 
is this: your software repaints the screen; 
the borders are slightly smaller than is 
normal on the Z100. Suddenly, the size of 
the screen changes, and the borders ex¬ 
pand until the first column of text is 
slightly behind the screen bezel. From 
time to time, there’s also a sudden flash of 
white (or bright green). 

Finally, the contrast between the high- 
intensity display and normal display is 
very great. Usually, you can’t read normal 
intensity very well, but the high intensity 
is overly bright. 

With the exception of software that 
required the use of the serial port, com¬ 
patibility with the IBM was quite high. 
The current version of the UCI board ran 
such software as Flight Simulator and 
Framework without incident. It did not 
seem to have any problem with 8- 
megahertz operation. (SuperCalc 3 did 
generate some “snow” on the screen.) 

Cutting traces 

Provided you can correct or live with 
the screen problem, one of the greatest 
causes of intimidation with the UCI board 
is the requirement to cut circuit traces 
and solder jumpers to circuit boards 
under some circumstances. I’ve already 
mentioned the need to remove a resistor 
from the Z120. 

You will have to cut traces and solder 
jumpers on the UCI’s video board if you 
are going to use an IBM-type color moni¬ 
tor instead of a Zenith Z100 color moni¬ 
tor. You’ll also need to cut traces and 
solder jumpers on the disk-controller 
board, if you wish to use 96-track-per- 
inch (t.p.i.) disk drives. 

If you already have UCI’s add-on 
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Fast ANSI Console Driver 


MAKE YOUR PC 
SEEM LIKE AN AT! 


MAKE YOUR AT 
SEEM LIKE A 
DREAM MACHINE! 

miNSI- 

CONSOLE"” 

The Integrated Console Utility ™ 

FAST, POWERFUL 
ANSI.SYS REPLACEMENT 

For the IBM-PC, AT, and clones 

New Version 2.00 is MUCH FASTER! 
Now blink free scrolling on CGA! 

GET A BOX FULL OF UTILITIES! 
MAKE LIFE EASIER FOR ONLY $75! 


Speed up your screenwriting 2-6x 
Extend your ANSI.SYS to full VT100 
Add many more escape sequences 
Scroll lines back onto screen 
Save scrolled lines into a file 
Add zip to your cursor keys 
Free your eyes from scroll blinking 
Easy installation 
Get a 43 line screen w/EGA 
Get a 50 line screen w/CGA 
No more annoying typeahead beep 
Prevent screen phospher burnin 
Control many programs’ use of color 
Generate breakpts from keyboard 
Shorten that annoying bell 
Over 40 other useful options 




© 
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“The psychological difference is 
astonishing” 

—Lotus June 85 pg 8. 

“So many handy functions rolled into 
one unobtrusive package’’ 

—PC-World Feb 86 pg 282. 

“The support provided by the 
publishers is extraordinary’’ 

—Capital PC Monitor May 86 pg 25. 

.. the best choice for improving your 
console ...” 

—Capital PC Monitor June 86 pg 282. 
400p Manual (w/slip case) & disks $75. 

Satisfaction Guaranteed! 

Order Yours Today! 

HERSEY MICRO CONSULTING 
Box 8276, Ann Arbor, Ml 48107 
(313) 994-3259 VISA/MC/Amex 
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IBM PC Emulation Strategy 


It is possible to make a Z100 behave 
like an IBM Personal Computer. It s 
even possible to make it happen fairly 
effectively. There are three products 
that I will be reviewing in Sextant , and 
they each take a different approach to 
solving this problem. 

Briefly the approaches can be de¬ 
scribed as hardware-only, hardware/ 
software, and software-only. These are 
loose descriptions, but they will do to 
set the methods apart. You should 
note that nothing in these descriptions 
is absolute. The hardware approach 
does require some software, and the 
software approach can use some addi¬ 
tional hardware to good advantage. 

The UCI EasyPC board is the most 
hardware-oriented product. Essen¬ 
tially, it is like putting an IBM-PC 
clone inside your Z100, and using the 
peripherals for support. This is why 
the product consists of three circuit 
boards and a wiring harness. Because 
all of the work is done by hardware, 
the UCI method produces the fastest 
machine, and the most effective 
screen handling. 


The Gemini emulator board makes 
very heavy use of ROM-based soft¬ 
ware, and it has its own CPU just to 
handle the emulation. This results in 
much less hardware being used, easier 
installation, lower cost, and probably 
more effective emulation. The use of 
software for much of the emulation 
does result in slower operation, but it 
also means that problems can be 
corrected sooner. As Motorola’s Bill 
Lucas once said, “Nobody’s ever come 
up with an editor for hardware.” 

The Heath Users’ Group’s ZPC takes 
the software-only approach. As with 
the Gemini board, this makes it easy 
to update, but there are limits to what 
software alone can accomplish. In this 
case, the result is less effective emula¬ 
tion, which means that you may have 
to patch some software so that it will 
run with ZPC. The addition of some 
hardware to the Z100 will help this 
system. The software-only approach 
does have an advantage in flexibility, 
since it is simply a program which is 
called as needed. 


memory board, you’ll have to cut traces 
there, too. There is no provision for 
removable jumpers, DIP switches, or 
jumper blocks. 

While many people won’t mind making 
the changes, many will mind. Many users 
are unwilling to start cutting traces on an 
expensive circuit board. I’ll have to admit 
that I consider cutting traces an un¬ 
acceptable requirement. 

If, however, you have the low-profile 
unit with a standard Zenith monitor, this 
problem should not arise. 

Documentation 

To its credit, UCI made all steps of 
installing and using the EasyPC board 
(including trace cutting) very clear in the 
manual. Although my copy appeared to 
have been produced on a copier, the man¬ 
ual is complete, clear, and well organ¬ 
ized. Every detail of operation is well 
explained, so that even the advanced user 
will be satisfied. 

In the appendices, the EasyPC manual 
tells you everything from the hexadec¬ 
imal addresses for memory mapping to 
the hex codes produced by individual 
keys on the keyboard. There’s very little 
even the advanced programmer will find 
to be missing. 

One welcome feature is a complete 
troubleshooting guide. Also included 
with the documentation is a keyboard 
template that indicates which Z100 keys 
are assigned to which IBM key functions 
during operation in the IBM mode. 


Installing the EasyPC 

In order to install the EasyPC board, 
you have to disassemble your Z100 far 
enough to reach the motherboard, re¬ 
move nine IC chips, plug in three boards 
and a wiring harness, and reassemble the 
whole thing. To some extent it’s a tedious 
job, but it really is not difficult. The 
manual explains the disassembly process 
completely. 

Briefly, you have to remove the cover of 
the computer, then get the disk drives out 
of the way (and the monitor if you have an 
all-in-one). To do this, you remove four or 
five screws, unplug the disk drive’s power 
and data cables, and lift away the drives. 
You also need to remove the monitor 
connections if you have an all-in-one 
version. 

At this point, you are confronted with 
the video board, which is screwed to the 
motherboard; covering them partly is the 
keyboard. You lift the keyboard off, un¬ 
plug it, and set it aside. You also need to 
unscrew the video board and remove it 
from the computer. Finally, you need to 
unplug the disk-drive controller board 
from the S-100 cage, and remove that. 

Now you’re down to the motherboard. 
You have those nine IC chips to remove, 
one of which is the Z 100’s 8088 central 
processor chip. Make sure you do this 
carefully, following the instructions in the 
manual. And make sure that you save the 
ICs carefully. If you have problems with 
the EasyPC board, you will have to put 
them back in again. The chips are not 
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New Low Priced Products for both CP/M & MS/DOS computers! 


TWIST & SHOUT! 

Sideways & Banner Printing 
Utility for Dot-Matrix Printers 


fllHIIlfS 


TWIST & SHOUT! is two great pieces of 
software packaged together at one low 
affordable price! 

TWIST lets you print out huge 
spreadsheets (or any text file) 
SIDEWAYS on your dot-matrix printer. 

It literally twists your printer's output 90 
degrees — no more cutting and pasting 
to put together a fragmented printout. 
Unlimited width printouts! 





SHOUT YOUR 
MESSAGE IN 
A BANNER! 

UllilUL 



For any CP/M or MS/DOS 
computer, just 

$34.95 

Special: one MS/DOS or ZDOS 
and one CP/M version for only 


$49.95 


SHOUT prints giant banners in letters 
from two to eight inches high using 
three special type styles. Make 
banners, posters and signs with ease. 
Anything you can type on the keyboard 
can be SHOUTed in gigantic letters! 


Hardware requirements: TWIST & SHOUT runs on any computer sup¬ 
porting CP/M, ZDOS, MS/DOS or PC/DOS. 'IBM Compatibility' is not 
required. Specify machine. Printers supported: Anadex, Apple, C. Itoh, 
Centronics, Data Products, DEC, Epson and compatibles, Hewlett 
Packard, IBM and compatibles, IDS, MPI, NEC, Mannesman Tally, Okidata, 
Smith Corona & Toshiba printers! More are being added daily. 


Solve Computer 
Incompatibility! 

MEDIA MASTER lets your Z-100 
computer or IBM compatible (PC, XT or 
AT) read, write and format up to 140 disk 
formats. Exchange information and 
programs with other computers for just 
$39.95. 

MEDIA MASTER PLUS 

all of the file transfer capabilities of 
MEDIA MASTER plus it gives your IBM 
compatible the ability to actually run 
CP/M software. All for just $59.95. 

ACCELERATE 8/16 includes 
MEDIA MASTER, an upgraded emulator 
and a special easy-to-install NEC V20 
chip which lets your IBM compatible run 
CP/M software at maximum speed. V20 
chip and software is just $99.95. 

Call or write for full compatibility chart 


MILESTONE 

Automatic Business Project Planner 

Originally $295—Now only $99.95! 

Never blow another deadline! Whether you're opening a branch office, 
hiring a sales force or launching a new product, nothing boosts the bottom 
line like being on time and within budget. Yet that kind of careful planning 
can take up a lot of your valuable time. Milestone brings all of the sure-fire 
planning methods of Critical Path Management together in one easy-to-use 
package for your personal computer. Here's how it works: You divide your 
major project into a number of smaller tasks. At Milestone's prompts you 
enter the manpower, cost and time estimates for each activity and indicate 
which tasks must be completed before others can start. Then Milestone 
does the rest, working out your entire schedule and budget (with holidays, 
sick days and even lunch hours taken into account). Milestone's clear and 
concise Time Schedule Report gives you a week by week chart showing 
detailed start and completion dates for each task, critical deadlines, 
manpower requirements and costs. Milestone is available for any CP/M, 
ZDOS, MS/DOS or PC/DOS computer and any printer. Specify computer. 



TECHNOLOGIES, INC. 

22458 Ventura Blvd., Suite E 
Woodland Hills, CA 91364 


We accept VISA, MASTERCARD and AMERICAN EXPRESS 
Order by mail or call our 24 hour toll free order line: 

800-824-7888 (Operator 407) 

Alaska, Hawaii: 800-824-7919 (Operator 407) 
Technical questions: 818-716-1655 (9-5 PST) 

Add $4 per order postage/handling. Overseas, add $12. 
US funds only. CA residents add 6% tax (LA County 6.5%) 
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Gemini update 


When the previous issue's review of 
the Gemini emulator board went to 
press, there were a number of en¬ 
hancements for it that had yet to be 
released. These include the H/Z100 
Sound Board ($29.95), which I had 
tested in an early stage of its develop¬ 
ment. This board has been released, 
so you can now get sound during emu¬ 
lation. Two other products have also 
been announced that could have a ma¬ 
jor impact on the emulator board. 
These are the H/Z100 Cradle Card, a 
card cradle to hold circuit boards 
meant for the IBM Personal Com¬ 
puter, and the PEGASys-f Graphics 
Adapter card (EGA) for the Z100. 

The card cradle is a device that 


plugs into the S-100 bus on the Z100, 
and translates the signals into those for 
an IBM bus. You can plug an IBM card 
into this device, and it will work as if it 
were in an IBM-compatible computer. 
You can also add an expansion chassis, 
and connect it using the card cradle. 

The EGA is designed for use on 
either an IBM clone or on the Z100. 
On the TOO, you connect it to the card 
cradle just mentioned. The board is 
designed so that it will work in either 
the Z100 mode or in emulation. 

For additional information about 
these enhancements, contact Gemini 
Technology, Inc., 13227 N.E. 20th 
Street, Bellevue, WA 98005. 


very static-sensitive, but there’s no harm 
in keeping them in conductive foam or in 
aluminum foil. 

Once you have the chips removed from 
the motherboard, you plug the 8088 into 
the EasyPC board. There are two IC 
chips that come with the EasyPC that you 
plug into the motherboard. Finally, you 
plug the EasyPC system board into the 
motherboard of your Z100. There are a 
number of connectors that need to be 
inserted into the sockets vacated by the 
chips you removed earlier. 

After you do this, you plug the video 
and disk-controller boards into the S-100 
bus connectors. Finally, you hook the 
connectors on the wiring harness to the 
indicated connectors on the computer 
and on the three EasyPC boards, and 
then attach the speaker. Once this is 
done, you reattach your video board, and 
then the keyboard. After that, reassembly 
of your computer is in the reverse order 
of disassembly. 


From that description of the installa¬ 
tion, and from a look at the Gemini 
emulator board, you’ll be able to see that 
there’s a lot more to the UCI board than 
there is to the Gemini. This additional 
hardware is probably responsible for the 
faster operation, and the somewhat bet¬ 
ter compatibility of software that does not 
use the serial port. It’s probably also re¬ 
sponsible for the somewhat higher cost. 

Using the EasyPC 

Once you get your computer put back 
together, it’s time to try out your new 
EasyPC board. 

When you turn the computer on, you 
hear a “beep’’ as always, followed by an¬ 
other “beep’’ from the EasyPC board. 
About the time you hear the second 
beep, a menu screen appears. It tells you 
that you have the UCI EasyPC board 
installed, and asks you to press “Z” for 
Z100 operation or “I” for IBM emulation. 
If you don’t do either and you have auto¬ 


boot enabled, the UCI board will pause, 
and then assume that you want to use 
IBM emulation and boot accordingly. 

Once the system boots, the software 
operation is entirely normal, for the most 
part. There is, though, the dim screen I 
mentioned earlier. If you have increased 
the speed on the Z100, the EasyPC board 
also speeds up. It seems to handle the 
7.5-MHz speed of the C.D.R. speed-up 
kit without problems. 

Reliability 

Most service for the UCI EasyPC 
board will involve sending it to your 
dealer or directly to the factory, depend¬ 
ing on where you bought it. 

During the time I had it, the EasyPC 
board spent a significant amount of time 
broken. Even sending it back to the com¬ 
pany did not solve the problem the first 
time. Fortunately, David Cheung of UCI 
was here in the Washington, D.C., area 
on business; it was only after a visit by Dr. 
Cheung that the board was functional 
again. 

The UCI technicians discovered a bad 
IC on one of the EasyPC boards. After 
several phone calls, and on the advice of 
UCI, I discovered an additional defective 
IC that was part of the EasyPC package. 

During its visit to the factory, the UCI 
board I had for review was upgraded to 
the most recent version. This made signi¬ 
ficant improvements in IBM compatibili¬ 
ty. I understand that this is standard 
practice at UCI. 

Overview 

There are a number of ways that you 
can achieve IBM-PC compatibility. The 
UCI EasyPC board is one way, and under 
some circumstances, it may be the best 
way. Still, at $699, it—like the Gemini 
board—is a relatively expensive route to 
compatibility that can never promise to 
be complete. 

For many users, a more appropriate 
route would be the purchase of an H148 


Make QUERY III 
your key to a 
world of 
information ■ ■■ 


Finally, a database 
management system you 
don't have to go to school 
to learn how to use. 


Our system is so easy to 
use, you'll be up and running 
10 minutes afteryou open the 
package. It's so versatile you'll 
never outgrow it. QUERY III is 
written in assembly language 
for super fast sorts and searches, 
and it's written with the user in 
mind, with lots of help menus 
and safety features built in. 
Eleven programs provide all your 
fundamental needs: Create, 
Add, View, Sort, Search, Printer, 
Writer, Redesign, Purge Recover, 
and Autopro. 

QUERY III user, Nat Sherrill 
of Sherrill Cellars, in Remark, 
October '85, says: "Might I 
suggest QUERY III published by 


Hoyle & Hoyle. Forjust $ 100, you 
get an extraordinarily well 
developed package of routines 
that easily match the performance 
of the over-advertised, over-priced 
and under-performance "hot- 
stuff" we always read about" 

Utoylf & Uloyle 

Software, Inc. 

111 Sparrow Drive 
Isle of Palms, SC 29451 
(803) 886-5802 

Available in HDOS, CP/M, MS-DOS, 
Z-DOS, PC-DOS. 

Order now or write for further 
information about QUERY III 
and support software. 

*99.95 Visa, MC, Choice, COD, 
or check. Shipped next working day. 
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kit while it's on sale. There’s about $200 
difference in the total cost; there’s also 
the building of the kit to consider, but the 
’148 is a remarkably easy kit—there’s 
not even any soldering. (An assembled 
single-drive T48 was on sale in the 
Fall 1986 Heathkit catalogue for $1,299.) 
With the ’148, you get virtually complete 
compatibility, and you leave your Z100 
untouched and free from compromises. 

If you are suffering a severe space limi¬ 
tation, or if you are under some other 
constraints that make the EasyPC attrac¬ 
tive, you should find it acceptable in 
many cases. For instance, you may have 
an internal hard-disk drive and want to 
use it with the IBM software; if so, 
something like the EasyPC may be an 
economical option. You should be aware, 
however, that installation of this device 
may have some significant effects on the 
overall operation of your Z100. 

For most users, however, there are 
many compromises to be considered. If 
you have a Z120, you must either suffer 
from a dim display, or start removing 
resistors. If you have a color display, you 
may have to do some cutting, this time on 
the video board. You’ll have to cut traces 
again if you have 96-t.p.i. disk drives. 

Winchester users will have to devote 
separate partitions to the Z100 and IBM 
data on their hard disks, since neither can 
read the other’s hard disk. (Again, that’s a 
limitation of the Gemini, and of emula¬ 
tion in general.) And, finally, anything 
that requires use of the serial port will 
not run without the addition of another 
board. 

Reasons for selecting the UCI 
EasyPC 

The primary reason you might want to 
choose the EasyPC over the Gemini 
board is the display. As I mentioned in 
the Gemini review, that board does not 
handle scrolling well at all, and screen 
displays are painted from the top down. 

By contrast, the screens produced by 
the UCI board appear all at once, just as 
they do with the Z150 (or the IBM). This 
higher-speed display will make the ap¬ 
pearance less confusing during rapid 
screen changes, including scrolling. 

Otherwise, your choice depends on 
the software you intend to use. If it runs 
on the UCI EasyPC, but not on the Gem¬ 
ini board, then the choice is obvious. 

An additional point of interest for some 
readers will be an enhancement which 
was introduced after I had completed 
most of this review. UCI now provides 
support for the 8087 math coprocessor in 
either Z100 mode or in emulation. 

Which would I choose? 

One of the nice things about being a 
reviewer is that I don’t have to choose. I 
had all the time I needed on both of 
the products in question, the Gemini 
emulator board and the UCI EasyPC. 
When I wanted to, I could insert one into 
my Z100 and use it as appropriate. 


But suppose I had to make a choice. . . . 

Of the two boards, the Gemini 
Emulator seems to be the better choice 
for most applications. In spite of the 
slightly slower operation, and the slow 
screen updating, the Gemini product is 
much less invasive. It is also less expen¬ 
sive, and requires fewer additional prod¬ 
ucts to provide complete emulation. 

In my Z100, the UCI board seems to 
have too many compromises. Remember, 
though, that I have a Z121. The UCI 
seems to have problems with screen 
brightness in this model. Users with low- 
profile ZlOOs probably will not have this 
problem, and many of the compromises 
will seem much less obvious. 

The final decision, of course, depends 
on what software you plan to run, and 
how often you plan to run it. If you expect 
to spend a lot of time running sophisti¬ 
cated operations, you’d probably be hap¬ 
piest spending the extra money on a true 
IBM clone. On the other hand, occasion¬ 


al use of a few pieces of software will put 
you right in line for one of these emula¬ 
tors. 

While the EasyPC does exhibit a com¬ 
mendable degree of IBM software com¬ 
patibility, it falls short as a useful 
product for many users. Depending on 
your specific needs, the Gemini emulator 
board from Gemini Technology could be 
a better choice. More likely, the addition 
of a computer that is designed to be IBM 
compatible would be the proper choice, 
and would avoid all of the compromises. 

Ordering Information 

EasyPC, $699; Easy87 8087 board, 

$75; I/O-l serial I/O board (one 
communications port), $99; 1/0-2 serial 
I/O board (two communications ports, 
game port, and clock/calendar), $139. 
UCI Corporation 
948 Cherry Street 
Kent, OH 44240 

800/UCI-COMP, 216/673-5155 A 


3 I H I U 5 SOFTWARE INC. 



Orders Only Florida Residents 

Please PHONE Inquiries 

1 - 800 - 423*7801 1 - 305 - 971-8068 

SIRIUS SOFTWARE, INC., 1524 N.W. 65th Ave., Margate, FL 33063 

Add $2.00 or 2% minimum for shipping and handling 
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The H89 SPEED Center 


4MHz mod 


$45 


An easy to install plug-in module. No trace cutting or soldering. 
Speed may be toggled with software. Includes a replacement 
Z80A (4MHz). Includes CP/M software support for Heath, CDR 
Systems and Magnolia. Call or write for info on HDOS support. 
\^pecify disk format. 


CDR Super RAM 89 

Make your H89 a speed whiz with this board and the included 
RAM drive software. With our 6MHz mod and the RAM drive, the 
Heath BIOS assembles (using MAKEBIOS) in less than IV 2 
minutes! Note our discount prices! 

Main board w/o RAM - specify disk format.$175 

Expansion board w/o RAM.$69 

Main board w/512K RAM.$239 

System w/MEGABYTE RAM.$369 

Clock option.$45 

SCSI option.$85 


REP3 - Automatic Key 
Repeat 

Stop wasting time - make full use of the repeat function just like 
the Z100. Simple plug-in installation on your keyboard 
assembly. Hold any key down for half a second and the key 
begins repeating. Combine this with our 4MHz mod and make 
WordStar fly! Provision for a defeat switch. 

Kit. 

Assembled. 


$35 
$45 J 


WSPATCH 


$20 


Adds H19/H89 function key patches to versions 3.0 or 3.3 of 
WordStar. Key functions similar to the PIE editor. Includes provi¬ 
sion for redefining the keys by the user. Also includes a printer 
^driver for the Epson MX80/FX80 printers._ 


EMULATE 

Allows the H89 to read/write to the following disk formats. 


Actrix 

Eagle II 

Morrow MD 

Superbrain Jr. 

AMPRO 

Epson QX-10 

NCR DecMate 5 

Televideo 

Beehive Tpr 

Fujitsu CP/M86 

NEC PC-8001 A 

TRS80-1 CP/M 

CDR 

IBM CP/M86 

Osborne 1 

TRS80-3 CP/M 

Cromemco 

IMS 5000 

Otrona 

TRS80-4 CP/M 

DEC VT180 

Kaypro II 

PMC MicroMate 

Visual 1050 

DEC Rainbow 

Magnolia 

Royal/Adler 

Xerox 820 



Sanyo 1100 

Zorba 


Now includes 44 formats! Uses a modified BIOS which is includ¬ 
ed with the program. Allows reading of 40-track disks in an 
80-track drive. 

For H37 with Heath CP/M. $59 

For CDR BIOS 2.91...$49 

Check for Magnolia version. 


^6MHz mod $ijT 

Similar to our 4MHz modification, but increases the CPU speed 
to 6MHz. Requires some soldering on the CPU board. Includes 
a replacement Z80B (6MHz). May require replacing additional 
parts. Some technical knowledge is recommended for installa¬ 
tion. CP/M support only. Specify disk format. _ > 

CDR Controllers N 

Double density disk controllers. Includes board, instruction 
manuals, ROMs and software. Allows control of 5 and 8 inch 
drives. Includes BIOS source code and some useful utilities. 
Please include your CP/M s/n when ordering. 


For the H89 FDC-88OH.$349 

V___ J 


ZCPR3 " 

We are licensed by ECHELON, Inc. to distribute the Z-System 
for the Heath market. This includes the ZCPR3 system with sup¬ 
porting software utilities, the ZRDOS-plus BDOS replacement 
and applicable documentation. Comes already installed and in¬ 
cludes a bootable disk ready to run. 

ZCPR Gives you many features found in UNIX and MSDOS. The 
ZRDOS is not in the public domain and gives you automatic 
logon of disks. No more “BDOS ERROR ON B:” messages just 
because you forgot to do a A C after changing disks. 

Available for Heath BIOS 2.2.03 and .04 and for CDR BIOS. 
Check for availability of other BIOS configurations. Call or write 
for a brochure on this excellent product. 

^ZCPR3 - specify format and hardware.$98^ 


TIM2 - Real Time Clock 

This circuit installs in the left hand expansion slots of the 
H89 or H89A. Can provide application programs with time 
and date information. Includes battery backup for con¬ 
tinuous timekeeping when the computer is turned off. Pro¬ 
gram access to the clock is through an I/O port. The port ad¬ 
dress is user selectable by means of a jumper. Requires 
soldering 4 wires to the CPU board. A prepared ribbon cable 


is included. 

Kit.$65 

Assembled.$75 

Software on disk - specify disk format.$10 


DATESTAMPER 

Product of Plu*Perfect Systems. Provides automatic time 
and datestamping for CP/M 2.2 files. Works with many real 
time clocks, including our own TIM2 product. 

^CP/M - specify disk format.$45 J 


— 

ANALYTICAL 


805/688-0826 


213 Teri Sue Lane 


Buellton, CA 93427 


Specify Disk Format on Software 

CALL OR WRITE FOR CATALOG PRICES SUBJECT TO CHANGE 

Terms: Check or Money Order - VISA/MC - C.O.D. 

Add $3 per order for shipping and handling 
California residents add 6% tax 

___ J 
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The Eight-Bit World 


Walter J. Janowski 


Taking a look around 

Where we’ve been 

Where we’re going 

Yes, you can still buy 
eight-bit products 

GEnie update 

Next time 

Correction 

Talk to me 


Taking a look around 

It’s early summer as I write this install¬ 
ment, although you probably won’t be 
reading it until mid-autumn. My kitchen 
remodelling is progressing well, although 
there’s still quite a bit to be done. 

This being the fifth installment of “The 
Eight-Bit World,” it might be a good time 
to stop and get our bearings, taking a look 
at where we’ve been and where we’re 
going. 

Where we’ve been 

Judging from the response I’ve re¬ 
ceived to this column, I think we can 
safely say that the Heath/Zenith eight-bit 
user community is definitely not extinct. 
Apparently there are quite a few of you 
who realize that a fully functioning micro¬ 
computer can be an extremely useful and 
interesting tool, even if its manufacturer 
no longer continues to produce it. 

We can also say there is a very real 
interest in new products for eight-bit ma¬ 
chines. Whether or not this interest will 
translate into dollars spent in actual sales 
of new products remains to be seen. 
Nonetheless, eight-bit users seem hungry 
for something new. 

We’ve also established a “meeting 
place” in the print media to which we can 
turn for information. More in future 
columns on how we can utilize this. 

Where we’re going 

As vendor support for eight-bit prod¬ 
ucts continues to dwindle, it becomes 
even more important to support those 
that remain. If there is a product on the 
market in which you have an interest, 
pursue it, and pursue it legitimately. A 
new software or hardware purchase in¬ 
creases the value of your machine as it 
makes it more useful. And the purchase 
price is small compared to the cost of 
converting to one of those “other” 
systems. 

Also, don’t feel that having an older 
machine exempts you from the responsi¬ 
bility of obtaining your software legiti¬ 
mately. Don’t gripe about how the 
vendors won’t produce products for you 
to buy while at the same time you’re 
passing out (or collecting) bootlegged 
software left and right. Heath/Zenith 
users are among the most responsible 
around; we need to keep it that way. 

Close-out specials are another tempt¬ 
ing bargain, but remember that every 
close-out is another nail in the coffin of 
your eight-bit machine. Take advantage of 
the specials when you find them, but 


don’t ignore a current product while wait¬ 
ing for it to be discontinued. 

This column has attracted a lot of 
information from vendors still producing 
eight-bit products, and I will report on 
some of it below. Let this column be a 
forum for distributing new information, 
as well as for collecting ideas on what you 
want to see. 

If you’re complaining about the lack of 
new software, let me know what software 
you’d like to see. Mentioning it here 
might inspire someone else to create it, or 
locate it if it already exists. 

It’s also time to put away some of our 
“snobbery.” While there was a time when 
it was legitimate to argue the virtues of 
the H8 versus the H89, or CP/M versus 
the Heath Disk Operating System, we 
can no longer afford to isolate ourselves 
this way. 

We might even stop to realize that long¬ 
time rivals like Kaypro, Morrow, Epson, 
Sanyo, Northstar, and others now all have 
their own alienated eight-bit user bases 
who share a common bond with us. We 
stand to gain from the combined knowl¬ 
edge of the serious users of all Z80/8080- 
based eight-bit machines. 

I recently got a letter from Jack Curtis, 
author of the Heath Users’ Group Z80 
assembler (part number 885-1078). He 
informed me that he has provided an 
updated version of the assembler to HUG 
for distribution, but that HUG has no 
plans to announce the update due to a 
lack of current sales of the product. 

This may be a disturbing indication of 
HUG’s intention to begin to turn its back 
on the eight-bit community. Without 
even HUG to provide us with support, it 
becomes even more important for eight- 
bit users to band together to distribute 
information and maintain our machines. 

Yes, you can still buy eight-bit 
products 

Over the past six to eight months, I’ve 
been receiving product information from 
vendors who still provide support for 
eight-bit machines. I will attempt here to 
briefly mention those from whom I’ve 
heard. 

If you value the contributions of these 
vendors, drop them a note telling them 
you intend to keep your machine active 
and that you value their continued 
support. (Sending along an order for one 
of their products sure wouldn’t hurt, 
either.) 

Please note that this list only implies 
that these vendors have contacted me to 
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Suppliers 

for Eight-Bit Systems 

C.D.R. Systems, Inc. 

The Soft Firm 

7210 Clairemont Mesa Blvd. 

P.O. Box 1125 

San Diego, CA 92111 

Picayune, MS 39466 

619/560-1272 

601/798-0740 

Dynacomp, Inc. 

SoftS hop 

1064 Gravel Road 

191 Leland Farm Road 

Webster, NY 14580 

Ashland, MA 01721 

Technical-service lines: 

617/443-9693 (6:00-8:00 p.m.) 

716/671-6160, 716/671-6167 

The Software Toolworks 

Echelon, Inc. 

9713 Santa Monica Blvd., Suite 204 

101 First Street, Suite 427 

Beverly Hills, CA 90210 

Los Altos, CA 94022 

Orders: 800/223-8665; in California, 

415/948-3820 

800/228-8665 

G.C.P.I. (Generic Computer 

T.D. Engineering 

Products, Inc.) 

13941 Olive Mesa Court 

P.O. Box 790 

Poway, CA 92064 

Marquette, MI 49855 

619/271-1077, 619/748-8529 

906/249-9801 

TMSI (Technical Micro Systems, 

Kamasoft, Inc. 

Inc.) 

2525 S.W 224th Ave. 

366 Cloverdale 

P.O. Box 5549 

P.O. Box 7227 

Aloha, OR 97007 

Ann Arbor, MI 48107 

503/649-3765 

313/994-0784 

McNeal Audio 

Trionyx Electronics, Inc. 

R3-8A Lake Sharon Drive 

P.O. Box 5131 

P.O. Box 904 

Santa Ana, CA 92704 

Warsaw, IN 46580 

219/269-3793 

714/830-2092 


say that they still supply eight-bit 
products. Unless otherwise mentioned, I 
do not have any direct experience either 
with the products or the performance of 
the vendors. My apologies to any suppli¬ 
ers who may have gotten lost in the 
shuffle. 

C.D.R. Systems, Inc. : C.D.R. markets 
a RAM disk for the H/Z89, as well as disk 
controllers for the ’8 and 89 and other 
products. Word of mouth seems to indi¬ 
cate that they are a very reliable company. 
And from the letters I’ve received, their 
RAM disk seems to be the most popular 
of those on the market. 

Dynacomp, Inc. : Here’s an interesting 
one. Soon after my first column appeared 
in print, I received a particularly rude 
letter from the president of Dynacomp. 
His letter took issue with my column; the 
letter stated that there does exist a lot of 
CP/M software, although very little new 
is being written, and that there is little 
advertising of CP/M software due to the 
low rate of return per advertising dollar. 

What’s most confusing is that this is 
just the point I have been trying to make 
in my columns. There are tons of pro¬ 
grams out there, if you can only find 
them. The Dynacomp catalogue confirms 
this, and reinforces my point that most 
existing CP/M software is pretty old. 


The 164-page catalogue contains most¬ 
ly Apple, Commodore, Atari, and IBM 
software. However, if you’re willing to 
wade through it, you will find one 
redeeming virtue. Dynacomp does dis¬ 
tribute the entire SIG/M and CP/M 
Users’ Group public domain software li¬ 
braries in soft-sectored H8/’89 format at a 
reasonable price. 

If you don’t have access to a modem 
and a bulletin board system, you might 
look to Dynacomp for your public domain 
software. 

Echelon, Inc.: Echelon markets ZCPR3 
for computers with the Z80 central pro¬ 
cessor. ZCPR3 replaces CP/M’s console- 
command processor (CCP) and gives you 
an enhanced set of commands to work 
with. They also offer ZRDOS, a re¬ 
placement for CP/M’s basic disk-output 
system (BDOS); when installed, ZRDOS 
produces Echelon’s “Z-System”—which 
effectively replaces CP/M altogether. The 
company also produces a number of 
powerful utilities for the Z-System. 

Echelon was kind enough to provide 
me with a complimentary subscription to 
their Z-News newsletter, which is packed 
with information about what’s new in the 
eight-bit world. The newsletter is nor¬ 
mally included with a Z-System pur¬ 
chase, and it is available for downloading 


on any of the “Z-Node” bulletin boards; 
located around the country, these bulletin 
boards are dedicated to the distribution 
of information and software pertaining to 
the Z-System. (Note that a Z-System pre¬ 
configured for the H/Z machines is 
available from Analytical Products.) 

G.C.P.I. (Generic Computer Products, 
Inc.): G.C.P.I. provides low-cost 

software for both HDOS and CP/M, 
although a recent flyer indicated a close¬ 
out sale of HDOS products. 

Kamasoft, Inc.: For those who say 
there’s nothing new for CP/M, Kamasoft 
has released Out-Think, a new outline 
processor for CP/M similar to products 
such as Thinktank and Framework for 
MS-DOS. Out-Think claims to help you 
organize your thoughts into outline form. 

McNeal Audio: Tim McNeal wrote and 
distributes The Organizer. Born out of his 
personal necessity, this is a nifty little 
program for the ’89 that helps keep track 
of the files on your diskette collection. I 

I hope to see 
more Heath/Zenith 
users appearing 
on GEnie. 

will be reviewing this product in more 
detail in an upcoming column. 

The Soft Firm: This company still sup¬ 
ports and stocks software products for 
eight-bit systems, including an H17 Disk 
Support System containing a collection of 
programs that can be used for file recov¬ 
ery, disk repair, and disk-drive diagnos¬ 
tics. Advertising costs have eliminated 
mention of these products in their ads, 
but the company can be contacted direct¬ 
ly for a complete catalogue. 

Soft Shop: Jim Teixeira’s company still 
provides software for eight-bit machines, 
including support packages for HDOS 
such as Super SysMod2. (See “The Eight- 
Bit World,” in Sextant #21, March-April 
1985.) 

The Software Toolworks: Walt Bilofsky 
has been providing quality software at 
reasonable prices since the early days. 
Many of my personal favorite programs, 
such as PIE and TEXT, have come from the 
Toolworks. 

T.D. Engineering: Although I have no 
direct experience with their products, 
this company produces perhaps the least 
expensive RAM disks available, with a 
512-kilobyte version for the ’8 at $115, 
and a 256K version for the ’89 at $140. 

TMSI (Technical Micro Systems, Inc.): 
With “Long Live the ’89” as their motto, 
TMSI is one of the companies most com¬ 
mitted to the continuation of the ’89. 

Their product list includes an 8086 co¬ 
processor board, a “Flicker-Free Kit” for 
more reliable video operation, a kit for 
reducing the ’89’s power consumption 
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(and heat!), and exact replacements for 
the Z89-37 soft-sector controller board. 

They also distribute Write-Hand-Man, 
the desktop utility I mentioned in recent 
columns. (I will be reviewing WHM’s 
latest update next column.) 

Trionyx Electronics, Inc .: While TMSI 
has taken the ’89 under their wing, 
Trionyx has adopted the H8. Trionyx now 
markets the ’8 itself, along with a host of 
accessory boards including co-processor 
boards, disk controllers, memory boards, 
and more. They are perhaps the most 
dedicated supporters of Heath eight-bit 
equipment. 

Obviously, this is only a small sampling 
of the vendors who still support eight-bit 
products. Again, send me any informa¬ 
tion you might have about other vendors 
who are still willing to supply to our 
market. Distribution of this information 
is crucial to our ongoing survival. 

GEnie update 

The GEnie information network from 
General Electric continues to be one of 
the most exciting things happening in the 
CP/M world. Their CP/M RoundTable 
software library now has over 1,800 files 
filled with public domain software avail¬ 
able for downloading. 

During a recent visit on the HUG SIG 
of CompuServe, I saw there was discus¬ 
sion regarding whether or not the SIG 
should be moved or at least duplicated on 
GEnie. I don’t think we’ll see this in the 
immediate future, but we do have a short¬ 
term alternative. 

The bulletin-board sections of the 
RoundTables (R/T’s) on GEnie are organ¬ 
ized quite differently from those on 
CompuServe. GEnie’s bulletin boards 
are broken down into categories that func¬ 
tion like smaller bulletin boards within 
the main board. 

The system operator of the CP/M R/T 
on GEnie has graciously set aside a sepa¬ 
rate category within the CP/M bulletin 
board dedicated to the users of Heath/ 
Zenith eight-bit computer systems. Ini¬ 
tial participation has been light as the 
H/Z users slowly become aware of 
GEnie’s existence. 

However, as I mentioned earlier in the 
column, the continued survival of the 
eight-bit community depends upon ade¬ 
quate communication among the users. I 
feel we should take advantage of this op¬ 
portunity to establish an area where we 
can share our thoughts, gripes, and 
public domain software. While I realize a 
four-month publication lag time limits 
the rapidity of response to this column, I 
hope to see more Heath/Zenith users 
appearing on GEnie. 

Next time 

By the time the next column rolls 
around, I hope to be dealing with a fully 
remodelled kitchen. I also hope to be 
covering the latest release of Write-Hand- 
Man from TMSI, The Organizer from 


McNeal Audio, and IMP, the Improved 
Modem Program from Irv Hoff, author of 
many of the overlays and modifications 
for the MODEM7 series. 

With a little luck, I should be able to 
dig up some new information on eight-bit 
product support from the national HUG 
conference in Chicago in August. 

Correction 

In my last column, I gave you an out¬ 
dated address for ordering public domain 
software from the CP/M special interest 
group of the Amateur Computer Group of 
New Jersey. 

The correct address is: 

SIG/M 
P.O. Box 97 
Iselin, NJ 08830 

Talk to me 

Contact me with your comments, 
gripes, or ideas via GEnie, CompuServe, 


or U.S. mail at the addresses below. 

As usual, I will provide copies of public 
domain software mentioned in my col¬ 
umns if you send me a blank diskette and 
$5 to cover postage and handling. I can 
support H17 and H37 formats, single- or 
double-sided, CP/M or HDOS. (Sorry, 
48-track-per-inch drives only.) 

GEnie ID: WJJANOWSKI 
CompuServe ID: 72376,1652 
Walter J. Janowski 
1505 East Evans Avenue 
Valparaiso, IN 46383 

Ordering Information 

GEnie 

Information: 800/638-9636, ext.21; 
free on-line demo: 800/638-8369 
Half-duplex, 300 or 1200 baud; after con¬ 
nection, enter HHH<RETURN> At the 
U#= prompt, enter 

5JM11999, GENIE <RETURN >. A 
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Controlled Data Recording Systems Inc. 

Quality Products and Supportforthe Heath/Zenith Community 


New for the H/Z89-90 Computer Users: 

The Super RAM 89 Package 


Now get the speed and power of a high capacity 
Ram Drive System at a reasonable price. 

Using the Ram 89 package, standard software 
shows an immense improvement in speed. 

Depending on the software being run, programs 
may execute 10 times faster than when run 
through standard floppies. 

Now get RAM 89 Software 

HDOS DRIVER ° ny $35 

RAM 89 DVD supports RAM SYO: and SY1 



Ram 89 comes as a two card set that plugs 
into the left hand (16k expansion) side of the 
computer. No computer modifications 
required. 

Board 1 has two banks of 256k chips 
possible for a total of 512k. Either or both 
banks are able to use 64k chips instead. 
Board 1 can be used by itself, with board 2 
added at a later date. 

Board 2 has an additional 512k, plus it has a 
real time clock capability, and a SASI interface 
hardware capability. Board 2 piggybacks onto 
board 1. 


added autoload features, plus more! 

The Ram Drive Software (SR AM) allows one or two logical ram drives. The ram drive(s) can be located starting anywhere from logical A: 
toO: {standard drives get relocated). SRAM can be set to start at logical A: and warm boot with ram{ no floppy disk accesses needed). 
Ram drive attatches to any of the versions of CP/M 2.2 bios used in the H/Z89-90. 

GET A FULL MAGABYTE OF RAM FOR YOUR H/Z89-90 

Board 1 includes hardware manual and ram drive software with no ram: $190.00. Each 256 k bank, add $56.00. Board 2 (must have 
board 1). With no ram, no clock, no SASI $90.00. Each 256k bank, add $56.00. Ask about clock, SASI pricing. 


FORTHEH/Z89-90 COMPUTERS 
THE ONE CONTROLLER 

FOR 8” 

& 5.25” 
DRIVES 
THE 
FDC-880H 
RICE:$395 

Includes controller board CP/M boot prom. I/O 
decoder prom, hardware/software manuals BIOS 
source listing. HDOS driver now available for$ 50 . 00 . 

Now be able to run standard 8" Shugart compatible 
drives and 5.25” drives (including the H37 type) in 
double and single density, automatically with one con¬ 
troller. The FDC-880H operates with or without the 
Heath hard sectored controller. 



Z100 HARDISK CONTROLLER 

The CDR317 is the ULTIMATE IN HARD DISK 
controllers for the H/Z110-HH/Z120 computers 

o Direct replacement for the Heath/Zenith Z217 hard disk controller package, 
o Able to work with standard ST506/412 type Winchester Drives and the 
cartridge removable Syquest Drives. 

o Works with all standard Heath/Zenith drivers, operating systems, and Z217 
Boot Roms. 

o Is an intelligent SCSI host adaptor for future network expansion, 
o Less expensive than the Z217 controller, 
o Available now through your local Heath/Zenith dealers. 


FOR THE Z100 COMPUTERS 


For information about these products contact: 

Controlled Data Recording Systems Inc. 

7210 Clairemont Mesa Blvd. 

San Diego. Ca. 92111 Phone (61 9) 560-1 272 or contact a Heath/Zenith 
dealer that carries the C. D. R. Systems Inc. line of products. 

New - C. D. R Systems Bulletin Board (61 9);'560-8929 

Circle #108 on Reader Service Card 


SUPER DRIVES 85 

A powerful floppy drive package for the Z100 or any computer that 
can use 8' floppy drives. 

Two extended technology 5.25” drives in a package with interface 
cables, case and power supply, that look exactly like standard 8” 
floppy drives to the computer. Now have 2.4 megabytes of floppy 

file storage capacity in one 5.25 package. . ^ _ 

ONLY $495 LIST 

Dealer inquiries invited. 


THE ORIGINAL 

Z100 SPEED 
MODULE. RUN 
YOUR Z100 PRO¬ 
GRAMS FASTER 

The ZS100 runs the Z100 CPU 50% faster. (7.5 MHZ) in 
8088 mode. The ZS100 installs easily with no soldering. The 
ZS100 is externally switchable between speed mode and 
normal. The ZS100 improves the time performance of ap¬ 
plications packages with no software modifications needed. 
The ZS1 00 is for all Heath/Zenith 1 00, 1 1 0 and 1 20 series 
computers. 
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Upgrade the ZVM-134 
to Display 16 Colors 

The ZVM-134 color monitor can be modified to display all 16 colors supported 
by Z150 and Z200 computers. 

William Gochee 


If you own an H/Z150 or one of Heath/ 
Zenith s other IBM-compatible comput¬ 
ers, you may be using it with an older 
model eight-color monitor, such as the 
ZVM-134. If you’ve just added an IBM- 
emulator board to your Z100, you might 
also be using it with a ZVM-134. 

But if you’ve seen a newer monitor at 
work, such as the ZVM-133, you may 
have noticed that some IBM software 
produces greater color variety than you 
can get on your ZVM-134. The ZVM-133, 
it turns out, can display 16 colors—rather 
than just the eight that the ZVM-134 
displays. 

The IBM Personal Computer and com¬ 
patibles generate an Intensity signal along 
with the normal red/green/blue (RGB) 
data. This “I” signal allows you to have 
two levels of intensity of the regular eight 
colors so that the 16 colors can be 
produced. 

If you’ve seen those 16 colors and like 
them, you may want to convert your 
eight-color monitor to 16-color mode. It 
can be done with a cable change and the 
addition of a ready-made circuit board 
available from Zenith. 

(Yes, it might have been nicer if the 
older model had the lower model num¬ 
ber. Zenith, however, doesn’t number its 
products chronologically. Instead, the 
numbers usually indicate particular fea¬ 
tures, price range, etc. Besides the later 
addition of variable intensity, the 
difference between the two monitors is in 
their original selling price. When the 
ZVM-134 was released in late 1982, its 
price was $699; when the ZVM-133 was 
released in the fall of 1984, it was less 
expensive—costing $559.) 


Professor William Gochee has been on 
the faculty of Lewis University at 
Romeoville, Illinois , for 21 years. 

He is an assistant dean in the College 
of Arts and Sciences and a professor 
of religious studies. Hes been a 
licensed ham-radio operator for 30 
years. 


Not much difference 

I recently got a bargain price on a 
Zenith ZVM-134 RGB eight-color high- 
resolution monitor. Since I was going to 
use it with my ZFA-161 IBM-compatible, 
I wanted to make it operate like its coun¬ 
terpart, the more modem ZVM-133 RGB 
16-color high-resolution monitor. 

Getting into the circuits of the two 
monitors, I quickly found the only real 
design difference between the two (other 
than cosmetics): it is a single board called 
the RGB Gain Control Board (Zenith’s 
number 9-356). This board is present in 
the ZVM-133, absent in the ZVM-134. 

Take reasonable pre¬ 
cautions in working 
inside the monitor. 

Adding the 9-356 Gain Control Board to 
your eight-color ZVM-134 will turn it into 
the equivalent of a 16-color ZVM-133. 

(See Figure 1 for a wiring diagram of 
the 9-356 board as it is used in the ZVM- 
133. Figure 2 shows a diagram of the 
ZVM-134’s unmodified circuit. Figure 3 
shows a diagram of the ZVM-134 circuit 
including the 9-356 board.) 

Both models receive all their input 
from the computer through a connector 
labelled RGB IN. In the older ZVM-134, 
this is a 15-pin D-type connector. In the 
newer ZVM-133, this is a 25-pin connec¬ 
tor, one of whose wires carries the Inten¬ 
sity signal. In the ZVM-133, the 9-356 
board intercepts the RGB and Intensity 
signals from the input connector; it then 
processes these signals before they travel 
to the main board. 

In the older ZVM-134, no Intensity 
signal is expected. It simply runs the 
RGB signals (along with positive horizon¬ 
tal and vertical synchronization pulses) 
directly from the input to the main board. 
The RGB signals go to a connector socket 
labelled “E ”. 


(The wires for the negative horizontal 
and vertical pulses go directly from the 
input to the main board socket labelled 
“D”. We will not bother these wires.) 

Basically, all we need to do is: 1) add a 
line and a resistor to the monitor cable; 2) 
add a brightness control to the 9-356 
board; and 3) hook up connectors from 
the 9-356 board to the ZVM-134. 

The cost for this will be about $12. (See 
Table 1 for a parts list.) 

Some customary warnings 

Before going further, I should note the 
usual precautions and warnings. First, 
you will be altering the equipment. It is 
not too likely that many ZVM-134s are 
still under warranty; nonetheless, if yours 
is, you will void the warranty by modify¬ 
ing it. And I assume that any guarantees 
for the 9-356 board may similarly be 
voided when you use it in a “non- 
standard” way. 

More importantly, you will need to take 
reasonable precautions in working inside 
the monitor. There are high voltages at 
work here—and they do not all disappear 
after you turn the monitor off and 
unplug it. 

Caution must be exercised so that you 
do not come in contact with the yoke of 
the picture tube or with the high voltage 
compartment (on the right side). The 
ZVM-134 has a large empty area on the 
left side (looking from the rear), and the 
modifications will take place in this space 
well away from the danger area. Nonethe¬ 
less, be cautious: besides getting zapped 
by the yoke, etc., you could also severely 
damage the yoke, tube, etc., with an 
accidental blow. (And an imploding pic¬ 
ture tube shoots glass everywhere.) 

The initial task 

The first step is to add a new single¬ 
conductor shielded cable to the cable 
which runs from your computer to the 
monitor. This addition is necessary so 
that the Intensity signal can reach the 
monitor. (Any quality piece of single- 
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TO 9-227 

MAIN BOARD 


EXTERNAL BRIGHTNESS 



Figure 1. A wiring diagram of the 9-356 board as it is used in the ZVM-133. 


Parts List for ZVM-134 Monitor Upgrade 

1 RGB Gain Control Board (Zenith part number 9-356) at $10. 

1 Miniature potentiometer (any value from 5k to 50k ohms). 

A Radio Shack part number 271-1715 at $1.09, with shaft 
shortened accordingly, should work fine. 

1 Multi-wire connecting cable (Zenith/IBM compatible to ZVM-134). 
This should already be owned with the ZVM-134. One can be 
obtained from Zenith for $20 (part number ZVM-134-1 for 
Zenith/IBM compatible or ZVM-134-2 for IBM PC). 

1 Length of single-conductor shielded cable (same length as 
multi-wire connecting cable). 

1 150-ohm, 14-watt resistor (Radio Shack part number 271-1312) 

at 390 for five (or a 180-ohm, 14-watt resistor, if you can find one). 


Table 1. The 9-356 board contains most of the parts you will need to add to your ZVM-134 
for the 16-color upgrade. 


conductor shielded cable of the right 
length should work fine.) 

Figure 4 shows the wiring for the mod¬ 
ified cable. 

The computer’s color board outputs 
the Intensity signal on pin 6 of a 9-pin 
D-type connector socket. Disassemble 
the 9-pin D-type plug on the computer 
end of your monitor cable; then carefully 
solder the braid shield of the new, small, 
single-wire coaxial line to the connector 
plug where the factory soldered the 
cable’s braid shield. Then solder the 
inner conductor of the cable to pin 6. 

Reassemble the 9-pin connector, and 
proceed to disassemble carefully the 15- 
pin D-type plug on the monitor end of 
the cable. Check the ZVM-134 user’s 
manual carefully (page 12) to see how the 
pins on this plug are used. The picture 
there, however, is inaccurate in that it 
gives a couple of wrong pin numbers on 
the representation of the connector. Pick 
an unused pin for the new Intensity 
signal. I chose pin 15 since it was well out 
of the way of other pins which were 
in use. 

Upon carefully disassembling this plug 
connector, solder a quarter-watt 150-ohm 
termination resistor from pin 15 to the 
factory-ground connection. (A quarter- 
watt 180-ohm resistor would be prefer¬ 
able here, but is harder to find. The 150- 
ohm resistor works fine.) Also solder the 
new cable’s braid shield to the same spot. 
Then solder the inner conductor of the 
new shielded cable to pin 15. 

Reassemble the plug and proceed to 


disassemble carefully the 15-pin D socket 
mounted on the monitor; a new wire will 
be brought from pin 15 for use in the 
remaining steps. 

Wiring 

Research showed me that the 9-356 
RGB Gain Control Board contained al¬ 
most all needed parts (including a con¬ 
trast control mounted in its center), to¬ 
gether with most of the necessary color- 
coded wiring and connectors. The only 
part that had to be obtained elsewhere 
was a miniature potentiometer (5 to 50 
kilohms will work fine) to control the 
brightness. 

You will connect this brightness- 


control pot to the unlabelled three-wire 
female connector coming from the 9-356 
board. This cable includes a red wire 
(+ 12 volts DC—goes to the upper lead of 
the control), an orange wire (the control 
wiper—the center control lead), and a 
black wire (ground—the lower lead of the 
control). You may either plug the wires 
into the connector or cut off the connec¬ 
tor and splice the wires together as a 
friend did. I found that plugging the 
wires in was effective if I made certain 
that I had a good physical and electrical 
connection. 

Almost all of the 9-356 board’s con¬ 
nectors are labelled; hence, if you own a 
ZVM-134, all you need do is unplug the 
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Figure 2. A diagram of the ZVM-134’s unmodified circuit. 
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□ □ □ 


□ 

□ 


CALLED 8E2 IN THE LATE VERSION. IN 
THE EARLY VERSION IT IS UNMARKED. 

8A7 SHOWN HERE IS THE EARLY VERSION. IN THE LATE VERSION OF 9-356, PLEASE 
DISREGARD THE YELLOW WIRE - ALL OTHER WIRES SHOULD BE CORRECT AS SHOWN. 

9-356 WIRES ARE COLOR-CODED. THE ORIGINAL MONITOR'S WIRES ARE NOT COLOR-CODED 
THE SAME WAY. 


NEW WIRES ( ◄-► ) PUSHED INTO PLUGS 


Figure 3. A diagram of the ZVM-134’s circuit, modified to include the 9-356 board. 


old “E” connector plug from the main 
board s “E” socket; then the connector 
plug labelled “E” from the 9-356 board 
can be plugged into the main board in the 
old one’s place. 

The two wires coming from the “E” 
connector plug on the 9-356 board termi¬ 
nate in a small two-pin connector plug; 


these wires are for the horizontal (pin 1) 
and vertical (pin 2) positive sync pulses. 
Simply identify the pins in the old “E” 
connector plug (pins 1 and 2, respec¬ 
tively), and use two jumpers of #16 to 
#18 wire to transfer the signals over. 

The pins on the main board are about 
#16 to #18 in size; therefore, you should 


be able to shove the wires snugly into the 
connectors and get a good connection 
without soldering. (Experiment for a 
good fit.) 

Next, there is an unmarked 5-wire in¬ 
put connector plug on the 9-356 board. 
Connect it to the remaining pins of the 
old “E” connector plug (R,G,B signal 
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Your Eight-Color Monitor is Not a Zenith ZVM-134? 


You may wish to try this modifi¬ 
cation on a monitor other than the 
ZVM-134. If so, all of the information 
given in this article should be useful. 
But you must carefully apply the fol¬ 
lowing information to the circuitry of 
your unit. 

Note well that the connector “X” 
carries the DC to the 9-356 board. It 
has three wires: red, +12 volts DC; 


yellow, +26 volts DC; and black, 
ground. A careful look at the schemat¬ 
ic circuit diagram of your monitor may 
turn up voltage sources which you 
might utilize to obtain these voltages. 

This modification should be carried 
out only by someone with experience 
with electrical circuits, so that the 
original monitor will not be damaged 
by accident. 


wires and ground) plus the newly in¬ 
stalled wire for the Intensity signal. Use 
the same size wires. And use the same 
color code, if possible—red, green, blue, 
black (ground), and white for Intensity. 

(Looking from the rear of the monitor, 
near the center of the main board, start¬ 
ing from the left side, the “E” connector s 
pins are as follows: pin 1, positive hori¬ 
zontal sync; pin 2, positive vertical sync; 
pin 3, ground; pin 4, blue; pin 5, green; 
and pin 6, red. Pin numbers are also 
noted in Figure 3.) 

Next, connect the 9-356 board’s con¬ 
nector plug labelled “X” to the connector 
socket posts labelled “X” on the main 
board; this is just beside the board posi¬ 
tion of the “E” socket-posts. (The connec¬ 
tor plug labelled “8E2” on the 9-356 
board should be left as is; it was put there 
to supply the needed DC voltage for an 
“on” indicator on the ZVM-133.) 

Mounting 

There is a potentiometer/switch 
mounted on the 9-356 board which con¬ 
trols 8/16-color modes. When the pot is 
turned completely clockwise, you are in 
the 16-color mode. The counter-clock¬ 
wise position is for the eight-color mode. 

The switch is controlled by pulling the 
shaft of the potentiometer in or out. “In” 
gives green-screen operation for text, 
while “out” produces the white/color 
mode. Since the ZVM-134 already has a 


handy green/white switch, a second is 
really unneeded. However, they will both 
work. 

Where you mount the 9-356 board is a 
matter of taste. I preferred to have both 
8/16 and brightness controls accessible for 
tuning if necessary; so, I drilled holes in 
the right-hand side (as viewed from the 
front) of my ZVM-134 for the control 
shafts, and fastened the board to the in¬ 
side with the brightness control next to it. 

Others may just want to anchor the 
approximately 3" x 6" board securely 
somewhere inside their monitor and pre¬ 
set the controls before closing the back. I 
have found that there seems to be no drift 
on the controls; therefore, once they are 
set, they can be left alone. (Personal taste 


may require more latitude on the bright¬ 
ness control; you may want to mount it on 
the back of the unit, alone and out of 
the way.) 

With little more than half an hour of 
invested time, you can enjoy a more mod¬ 
ern 16-color mode which your Z150 or 
other compatible supports. 

Ordering Information 

9-356 RGB Gain Control Board, $10 
plus U.P.S. charges (Illinois residents 
add 7% sales tax). 

Parts Department 

Zenith Distributing of Illinois 

505 North Northwest Avenue 

Northlake, Illinois 60164 

312/562-7300 A 



Figure 4. In order to allow the Intensity signal to reach the monitor, a single-conductor shielded cable must be used in addition to the 
already-existing monitor cable. 
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Buss —and receive The Buss 
Directory FREE! 
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computerthan Buss. Twenty timesayear, you'll learn what other usersand suppliers are 
doing—for all Heath/Zenith machines. 


Take advantage of the 
opportunity to learn more 
about your Heath/Zenith 
system—with your 
subscription to Buss. 


Every issue features: 

* New product sources and upgrades 

* Users' advice and discoveries about their systems 

* ''Requests for Assistance"—Submit questions and 
interact with other users 
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Bevond 

IBM PC 
Compatibility: 



Z-100 users who are ready for PC compatibility, should 
keep one thing in mind. The future. New, state-of-the-art 
PC software is creating ever greater performance demands 
on computer hardware. Large scale, memory intensive 
programs for networking, graphics, number crunching 
and communications are quickly becoming the rule, 
not the exception. But software is only as good as 
the system that runs it. 


EasyPC will run it all. 

Even the newest copy-protected 
best sellers. That’s because you 
actually boot up PC hardware, 
not software translation routines. 

EasyPC runs faster, too. 

Faster than an IBM PC, faster 
than a Z-150, and faster than 
any other emulation scheme 
you can buy. 


imiiiimiiiiiii 




m 


iiiiiimmimii 


EasyPC will support a fully integrated 
Local Area Network System (LANS) 
of ZslOO\ PC’s and AT’s communicating 
at 115Kbaud. 


Networking is now a reality for Z-100 users. 

EasyPC will fully support a network of up to sixteen Z-lOO’s, 
PC’s and AT’s. EasyPC is the core of an integrated system 
of components that includes RAM expansion, I/O, math 
co-processing, hard disk subsystem and more. For serious 
users, it’s the only choice. 


Ask to see an EasyPC in action. 

Visit your Heath/Zenith Electronics Center or independent 
UCI dealer and see how easy it is to turn your Z-100 into a 
PC compatible system. For the name of your nearest dealer, 
just call 800-UCI-COMPUTER. 

EasyPC is a trademark of UCI, Corp. Z-100 and Z-150 are trademarks of Zenith Electronics Corp. 

IBM and IBM PC are trademarks of International Business Machines. 



/ ~I jJ CORPORATION 


948 Cherry Street, Kent, Ohio 44240 
(216) 673-5155 / 800-UCI-COMPUTER 
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Rigging Up a CTRL-P 

for HDOS 

Here’s how to send console output from HDOS to a printer through a parallel 
port—with some tips on adapting the software for a serial interface. 


Ferruccio G. Barletta 


I have owned my H89 for five years, 
and during that time I’ve relied a lot 
on the Heath Disk Operating System 
(HDOS). During that time, also. I’ve 
built a considerable “wish list” of features 
I’d like to see added to HDOS. 

Even though HDOS is a quite powerful 
and flexible operating system, it does not 
have the capability to print program out¬ 
put that normally goes to the screen. 
Working with CP/M and the Microsoft 
Disk Operating System (MS-DOS), I 
have grown accustomed to using CTRL-P 
to toggle console output to the printer. 

There are many uses for this kind of 
capability. For example, hardcopy of 
program results can easily be obtained 
even if a program does not have any provi¬ 
sions for it. 

Fortunately, HDOS is one of the few 
operating systems for which you can pur¬ 
chase a copy of the assembly-language 
source code. And after I had obtained the 
source code, I was determined to over¬ 
come the lack of a CTRL-P capability. 

The four most important design crite¬ 
ria for my solution were: 

1) The modifications to HDOS should 
use as little memory as possible. 

2) These patches should not interfere 
with normal HDOS operations in any 
way. (All programs should work exactly as 
they did before.) 

3) The changes should be reversible. 
They should be made to HDOS only as it 
resides in memory. No changes should be 
made to any system files on disk. 

4) The key used to toggle the output 
should not be one that might be used by 
another program. (I used the LINE FEED 
key since that key is totally ignored by 
HDOS, and therefore totally inaccessible 
to normal programs.) 

With these criteria in mind, I wrote 
two programs, CODE.ASM and LOAD.ASM. 
Shown in Listings 1 and 2, they run 
under HDOS version 2. 


Ferruccio G. Barletta is a senior 
systems analyst with Micro Computer 
Software, Inc. He's got a bachelors 
degree in computer science from 
Northeastern University. 


Listing 1 gives the CODE.ASM source 
code. CODE is the one that does all the 
work. It intercepts interrupt signals sent 
to the central processing unit by the key¬ 
board. This is done so that it may see 
whether the LINE FEED key has been 
pressed. CODE also intercepts any at¬ 
tempt by HDOS to send a character to 
the console; then it may send that charac¬ 
ter to the printer if the print toggle is 
active. 

Listing 2 gives the LOAD.ASM source 
code. LOAD determines how much mem¬ 
ory CODE will take up, and loads it into 
memory at the highest available location. 
By providing a relocating loader such as 
this, I do not have to worry about where 

These patches will 
send to the printer 
whatever you send to 
the screen. 

in memory the patches will be located. 
So, this code will work on any system 
having from 24 kilobytes (HDOS 2’s mini¬ 
mum) to 64 K. 

These two programs will be joined to¬ 
gether to produce the final program. 

Putting it together 

In order for these programs to work 
properly, the following steps must be 
followed: 

1) Assemble LOAD.ASM and CODE.ASM in 
order to generate LOAD. ABS and 
CODE. ABS. 

2) Append the two .ABS files to one an¬ 
other: 

PIP FIX.ABS = LOAD.ABS,CODE.ABS 
(Note: the order of the files is very im¬ 
portant.) This will generate a file called 
FIX. ABS that will install the patches into 
HDOS as it resides in memory. FIX.ABS 
needs to be run only once every time the 
system is booted. 

3) (Optional) Upon every boot-up, 
HDOS searches for a PROLOGUE file 
to execute; renaming FIX. ABS to 


PROLOGUE.SYS and placing it on SYO: will 
cause the patches to be installed automa¬ 
tically every time HDOS is booted from 
that disk. 

Installing the patches 

As noted above, the patches contained 
in CODE (Listing 1) will be installed into 
HDOS by LOAD (Listing 2). The PATCHES 
section, at the end of LOAD.ASM, does 
that job. 

In order to execute the routine that will 
detect when a LINE FEED has been 
pressed, LOAD places a CALL instruction 
in the HDOS resident system. This CALL 
is placed at the beginning of H DOS’s 
system character input interrupt routine 
(SCINl). 

The address of SCINl can be found by* 
inspecting the user-interrupt vector table 
(uivec). The CALL instruction is placed at 
a location in SCINl where standard HDOS 
has two instructions (CPI LF; RE). (That 
code does a compare to see if a character 
is a line feed; if so, it ignores it and 
returns.) LOAD replaces those two in¬ 
structions with a CALL to ENTRYl (in 
CODE.ASM). 

Whenever a key is pressed, HDOS 
executes a CALL SCINL If the key is a LINE 
FEED, then the routine ENTRYl will de¬ 
tect it, toggle the print flag (PFLAG), and 
return to the interrupted program. If it is 
another key, then the character will be 
returned to SCINl for further processing. 

Also, LOAD installs two patches into 
HDOS’s system character output routine 
(SCOUT). In each case, a CALL instruction 
replaces a POP PSW followed by an OUT. 
(They are located at line numbers 4267 
and 4276 of the listings of the system 
input/output handler. See volume 1 of the 
HDOS source code.) 

There are two places where character 
output may take place, because Heath/ 
Zenith computers use two different chips 
for serial communication with peripher¬ 
als. H/Z89 computers use an 8250 ACE 
(asynchronous communications element) 
at port 350 octal (Q)—as do H8s with the 
H8-4 serial board. H8 computers with 
the H8-5 serial/cassette board use an 
8251 UART (universal asynchronous re- 
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ceiver/transmitter) located at port 372Q. 
Since HDOS supports both the ACE and 
UART systems, it has code for both of 
those types of systems. 

Whenever a program attempts to print 
characters to the console (via the . SCOUT 
or . PRINT system calls) the modified 
SCOUT routine will CALL ENTRYO. If the 
print flag is off, ENTRYO will send the 
character to the console and return to 
HDOS. If the print flag is on, it will send 
the character to the printer and then to 
the console before returning to HDOS. 

Configuring CODE for other 
printers 

As they stand, the patches will work 
with an Epson printer connected to an 
H/Z89 with a parallel-interface board 
from FBE Research. 

To configure CODE.ASM for another 
parallel printer interface, the equate 
statements for PORT, MASK, and READY 
must be changed to specify the appropri¬ 
ate values. 

PORT is the printer-interface port at 
address 320Q. (Most other interfaces use 
340Q as the printer port.) The FBE inter¬ 
face uses the highest two bits of the 
printer port as status lines. (A 1 on bit six 
indicates the printer is on-line; a 0 on bit 
seven indicates it is ready to receive.) 
Concerning other printers/interfaces, the 
points to note are that MASK is used to 
select the bits which should be tested, 
and that ready should be set to the 
pattern of bits which indicates that the 
printer is ready. 

The WCCO section reads a byte from 
PORT and ANDS it with MASK (300Q, or 
1100 0000 binary); the result is then com¬ 
pared with READY (100Q, or 0100 0000b) 
in order to determine whether the 
printer is ready for another character. 

As they’re given in Listing 2, the 
patches will work with the 8250 ACE. If 
your computer uses the 8251 UART, then 
the equates SPORT and DPORT must be 
changed to reflect your port assignments. 
SMASK is defined as 040Q (0010 0000b) 
since the console status is given by bit five 
at port 355Q. In WCC2, SMASK is ANDed 
with the byte at SPORT to determine con¬ 
sole status. 

(For configuring CODE. ASM for a serial 
printer, see the comments accompanying 
this article.) 

PIC vs. ABS format 

Having addressed the operation of 
CODE, we should take a look at LOAD. ASM 
to see how it loads CODE into memory. 

However, before going into the opera¬ 
tion of LOAD itself, it may be good to look 
at how HDOS executable programs in 
general are loaded into memory. Here, 
the distinction that concerns us is be¬ 
tween position-independent code (pic) 
programs and ordinary “absolute” (abs) 
programs. (Both kinds of programs will 
have the same .ABS extension, but the 
assembler and HDOS will treat ABS files 
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INX 

SP 

returning to caller's caller 


RET 



PFLAG 

DB 

0 


PORT 

EQU 

320Q 

printer port 

MASK 

EQU 

300Q 

printer status mask 

READY 

EQU 

100Q 

printer ready status 

SPORT 

EQU 

355Q 

console status port 

SMASK 

EQU 

040Q 

console status mask 

DPORT 

EQU 

350Q 

console data port 

WCC 

PUSH 

PSW 

write console character 


LDA 

PFLAG 



ANA 

A 



JZ 

WCC 2 


WCC0 

IN 

PORT 

write character to printer as well 


ANI 

MASK 



CPI 

READY 



JNZ 

WCC0 



POP 

PSW 



OUT 

PORT 


WCC1 

PUSH 

PSW 

write to console 

WCC 2 

IN 

SPORT 



ANI 

SMASK 



JZ 

WCC 2 



POP 

PSW 



OUT 

DPORT 



RET 




END 




Listing 1. CODE.ASM, source code for one part of FIX.ABS, which provides HDOS with a 
function to send to the printer whatever appears on the screen. CODE does the actual 
work; it is patched into HDOS by LOAD (the other part of FIX). 


Listing 2. LOAD.ASM. Together with CODE.ASM (Listing 1), this provides the source code for 
FIX.ABS. LOAD patches CODE into HDOS to provide a capability similar to that of CP/M’s 
CTRL-P function. 


LOAD.ASM 

TITLE 'RELOCATING LOADER’ 
system definitions 


USERFWA 

EQU 

2280H 

$TYPTX 

EQU 

31136A 

$CHL 

EQU 

30224A 

.READ 

EQU 

4Q 

.ERROR 

EQU 

57Q 

.EXIT 

EQU 

0Q 

.VERS 

EQU 

11Q 

.SETTP 

EQU 

52Q 

S.RFWA 

EQU 

40356A 
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S.SYSM 

EQU 

40320A 




S.USRM 

EQU 

40322A 





0RG 

USERFWA 




BUF 

DS 

256 

data buffer 



IND 

DB 

0 

index into buffer 



* get a 

single byte from the code file 



GETB 

PUSH 

H 





PUSH 

D 





PUSH 

B 





CALL 

GETB. 





POP 

B 





POP 

D 





POP 

H 





RET 





GETB. 

LDA 

IND 

get index 




ANA 

A 

if index=0 then read 

another sector 



CZ 

GETBL 





MOV 

C, A 





INR 

A 

increment index 




STA 

IND 





LXI 

H,BUF 





MVI 

B,0 

add index to buffer 




DAD 

B 





MOV 

A,M 

get data byte 




RET 





GETBL 

PUSH 

PSW 





PUSH 

B 





PUSH 

H 





LXI 

B.256 





LXI 

D ,BUF 





MVI 

A i-1 





SCALL 

.READ 





JC 

ERROR 





POP 

H 





POP 

B 





POP 

PSW 





RET 





* get a 

word (L0,HI) from code file 



GETW 

PUSH 

PSW 





CALL 

GETB 





MOV 

L,A 





CALL 

GETB 





MOV 

H,A 





POP 

PSW 





RET 





* print 

error 

message and exit 



ERROR 

MVI 

H, 12Q 





SCALL 

.ERROR 




EXIT 

XRA 

A 





SCALL 

.EXIT 




* data 

cells 





MAXMEM 

DS 

2 




LENGTH 

DS 

2 




POINTER 

DS 

2 




FWA 

DS 

2 




* program entry point 




LOADER 

SCALL 

.VERS 





CPI 

20H 





JZ 

LOADER. 





CALL 

$TYPTX 





DB 

•HD0S 2 

.0 required for this 

software *,212Q 



JMP 

EXIT 




LOADER. 

CALL 

GETW 

skip PIC header 




LXI 

H,-1 





SCALL 

.SETTP 





LXI 

D ,-10 





DAD 

D 





SHLD 

MAXMEM 

grab all available memory 



SCALL 

.SETTP 





H89 20-MEGABYTE 
WINCHESTER 

TIRED of swapping floppies 
and living with limited space? 
•20-meg or two logical 10-meg drives 

• Completely integrated Heath BIOS 

• Uses left-side memory slot 
•Attractive internal mounting 

• Seagate ST225 drive 

INTRODUCTORY PRICE: 
ONLY $795 


External option.$175 

Printer Port.$10 


SOFTWARE FOR ALL 
ZENITH COMPUTERS 

PERFECT PRINTER 

Electric typewriter (2 modes) PLUS 7 

print functions.$19.95 

PAYCHECK 

Payroll program with multiple wages, 
salaries, tips, federal taxes, and 
MORE! Prints checks, quarterly/annual 


reports.$39.95 

MT ACCOUNTANT 

Organizes financial data by account or 

date. Easy to use!.$19.95 


ORDER NOW by writing 
or calling: 

Micronics Technology 
(904) 897-4257 
449 Barbados Way 
Niceville, FL 32578 
We accept checks, Visa, MasterCard. 
Shipping: software, $2 

Winchester, $20 
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SOLARSIM 

James Tursa 

/^gs-Sgfpr The Solar System 
Simulation Program 

SOLARSIM is a dynamic 3-D color 
graphics simulation of our solar system 
and nearby star systems. It simulates 
the planets, 250 asteroids and comets 
(including Halley’s), and over 800 
stars, nebula and galaxies (you can add 
more!). View and identify the stars and 
solar system from any point on Earth 
or nearly any point in space and at any 
specified time or date. Great for stellar 
navigation, tracking comets and plan¬ 
ets, and learning the positions and 
shapes of the constellations. SOLAR¬ 
SIM comes with a high-quality 50-page 
manual. SOLARSIM (IBM e version) has 
both medium-resolution color and 
high-resolution single color modes. 

Only $29.95 for a limited time! 

(Please add $2 for shipping. Texas residents add 
sales tax. Overseas orders should add an extra $5 

Available for the IBM PC/XT/PCjr/AT and 
compatibles. Zenith© Z-100, and the TI© Pro. 

System Requirements: 

128K RAM & Color/Graphics Adapter (IBM) 

192K RAM (Z-100) 

256K RAM (TI Pro) 

DOS 2 or later (except Z-100) 

Send check, money order or COD orders to 
CYGNUS, P.O. Box 57825, Webster, TX 77598, 
'713) 486-4163 

Credit card orders only: 

«800) 622-4070 (Nat’l) 

1800) 942-7317 (ILL) 
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differently from the way they treat PIC 
files.) 

In our case, LOAD will be an ABS file and 
CODE will be a PIC file. 

The source code for the two types of 
programs could be almost identical. The 
difference is that a PIC file will include the 
instruction CODE PIC. This directs the 
assembler to generate position-indepen- 
dent code. What this means is that when 
the program is assembled, its address 
values will be generated as if it were going 
to be loaded at a fixed location in memory. 
(Location 6 is the value used.) However, 
the assembler will also generate a reloca¬ 
tion table and place it at the end of the 
.ABS file. This will allow the code to be 
placed anywhere else in memory, and 
still work correctly. 

Now we can move to the actual opera¬ 
tion of LOAD. 

How LOAD.ASM works 

You may have noticed that nowhere in 
LOAD. ASM is there any code to open a file 
containing patches. 

When HDOS loads FIX. ABS into mem¬ 
ory, the first thing it sees will be LOAD S 
ABS header; therefore, after LOAD is read 
into memory, H DOS’s read pointer will 
be positioned at the end of the absolute 
portion of FIX —that is, the end of LOAD. 
This, in turn, is the beginning of the PIC 
portion—the beginning of CODE. When 
HDOS executes FIX, then, it will actually 
load only LOAD into memory. 

When HDOS transfers control to 
LOAD, LOAD is going to have to size up the 
patches: code’s PIC header will warn 
LOAD to determine how much memory 
the patches to HDOS will take. The re¬ 
location table will be used in recalculat¬ 
ing address locations within CODE for the 
new location in high memory. LOAD will 
then allocate all available memory so that 
it may place the patches at the highest 
possible address, right up underneath the 
space taken by the operating system. 

LOAD.ASM divides the task into three 
main subroutines: LOAD, RELOC, and 
PATCHES. The subroutine LOAD simply 
reads data from channel -1 and copies it to 
the high end of memory until it reaches 
the end of the position-independent 
code. 

The subroutine RELOC does most of the 
work. It reads from code’s relocation ta¬ 
ble located at the end of FIX, and recalcu¬ 
lates addresses within the patch code. 
Each entry in the relocation table points 
to an address within the code that must be 
altered if the code is moved. The new 
address is calculated as follows: 
NewAddress = Code [Old Address] + 
StartOfRelocatedCode - 6 

After the code has been relocated, the 
routine PATCHES is called to install code’s 
changes into the HDOS system residing 
in memory. PATCHES will also modify the 
HDOS system variables S.SYSM (system 
memory), S.RFWA (resident HDOS first 
working address), and S.USRM (user 
memory) so that neither HDOS nor any 



JC 

ERROR 




CALL 

GETW 

get the rest of the header 



SHLD 

LENGTH 




CALL 

GETW 




SHLD 

POINTER 




CALL 

$CHL 




XCHG 





LHLD 

MAXMEM 




DAD 

D 




SHLD 

FWA 

FWA = first byte of relocated code 



CALL 

LOAD 




CALL 

RELOC 




CALL 

PATCHES 




JMP 

EXIT 



* load 

unrelocated code 



LOAD 

LHLD 

POINTER 




LX I 

D ,-6 




DAD 

D 




XCHG 


DE = byte count 



LHLD 

FWA 

HL = address of next byte 


LOAD. 

MOV 

A,D 




ORA 

E 

any more? 



RZ 





CALL 

GETB 




MOV 

M,A 




INX 

H 




DCX 

D 




JMP 

LOAD. 



* relocate loaded code 



RELOC 

CALL 

GETW 




MOV 

A,H 




ORA 

L 

last word = 0 



RZ 





LXI 

D ,-6 

offset for 6 byte header 



DAD 

D 




PUSH 

H 




LHLD 

FWA 




XCHG 





POP 

H 




DAD 

D 




MOV 

E,M 




INX 

H 




MOV 

D,M 

get word to relocate 



DCX 

H 




PUSH 

H 




LHLD 

FWA 




LXI 

B,-6 




DAD 

B 




DAD 

D 

add relocation offset 



XCHG 





POP 

H 




MOV 

M,E 

store relocated word 



INX 

H 




MOV 

M,D 




JMP 

RELOC 



* make 

patches 

to resident HDOS system 


PATCHES 

LHLD 

S.RFWA 




XCHG 





LHLD 

FWA 




DCX 

H 




SHLD 

S.SYSM 




SHLD 

S.RFWA 




INX 

H 




PUSH 

H 




PUSH 

D 




LXI 

H,RMEML 




SHLD 

S.USRM 




POP 

D 




POP 

B 

B = first byte of relocated code 


.UIVEC3 

EQU 

40045A 

console interrupt vector 


.DISP1 

EQU 

2010A 

displacements from SCINI 


.DISP2 

EQU 

2025A 



.DISP3 

EQU 

045A 



.CALL 

EQU 

0CDH 

CALL opcode 








36 Sextant November-December 1986 




DI 





LHLD 

.UIVEC3+1 




LX I 

D , .DISP1 




DAD 

D 




MVI 

M,.CALL 

insert 

CALL 

(FWA) 

I NX 

H 




MOV 

M,C 




INX 

H 




MOV 

M,B 




LHLD 

.UIVEC3+1 




LXI 

D , .DISP2 




DAD 

D 




MVI 

M, .CALL 

insert 

CALL 

(FWA) 

INX 

H 




MOV 

M,C 




INX 

H 




MOV 

M,B 




INX 

B 




INX 

B 




INX 

B 




LHLD 

.UIVEC3+1 




LXI 

D,.DISP3 




DAD 

D 




MVI 

M,.CALL 

insert 

CALL 

(FWA)+3 

INX 

H 




MOV 

M,C 




INX 

H 




MOV 

M,B 




El 





RET 





DS 

10 




RMEML EQU 

ft 




END 

LOADER 





HEATH/ZENITH 
88, 89, 90 PERIPHERALS 


16K RAM 

EXPANSION 

CARD 


Only $65.00 

Shipping & 
Handling $5.00 


REAL TIME 
CLOCK 

Price $130.00 with 
Batteries 

Shipping & 
Handling $5.00 
$114.00 without 
Batteries 


2 PORT 
SERIAL 

3 PORT 
PARALLEL 

I / O CARD 


Price $199.00 
Second Operating System Driver $25.00 

Shipping & Handling $10.00 

PRICES ARE LESS SHIPPING & TAX 
IF RESIDENT OF CALIFORNIA. 

MAIL ORDER: 12011 ACLARE STREET, 
CERRITOS, CA 90701 

( 213 ) 924-6741 

TECHNICAL INFO / HELP: 

8575 KNOTT AVENUE, SUITE D 
BUENA PARK, CA 90620 

( 714 ) 952-3930 

TERMS & SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE 
VISA & MASTER CARD GLADLY ACCEPTED 
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THE ORIGINAL SERIAL/PARALLEL INTERFACE BOARD 



I/O Board 

Replace the H88-3 to upgrade your system or use the KC 1222 in place of it! Providing the two 
standard serial ports PLUS three parallel ports on one card, you have the best of both worlds! Use the 
parallel ports for printers, joystick, intrumentation/controll...KC 1222 has components including 
cables and hardware. KP 1222 has the same items less the serial chips and serial cables. 

KC 1222 Complete Kit SI 28 

KP 1222 Parallell Kit 97 

PC 1222 Bareboard 48.50 

Printer Drivers 

The C. Itoh, Epson, Okidatas, Gemini and others are supported under HDOS and Heath's CP/M S20 
Magnolia Patch $10 


ZDS HARDWARE • PRINTER PACKAGES • SOFTWARE 

MATHGEN: The keyboard math interpreter brings mathematics to life! Function roots, max and min. 
evaluate function integrals and first derivatives, hyperbolics, exponential forms, logs, trig functions, 
factorials, the list goes on! Define the functions from a file, batch processing style, or from the 
keyboard. Plot to the screen or your printer. CP/M or HDOS for only $40.00. Now for Z-Dos, too! 

DATAPLOT: Using the dot addressable graphics of your Prowriter, plot any definable math function in 
single or double density. Select axis size and scale, plotting quadrant, etc, Generate your data by 
MATHGEN, MBASIC or any other language. CP/M or HDOS for $25.00. 

PRN: A printer utility for the Prowriter, Epsons, and HI 4. Print headers, footers, pause at page end, 
print multiple copies, left margin, printer mode and a host of other functions. CP/M or HDOS for 
$25.00. 

JS: Use your parallel ports for REAL TIME joysticks! Use up to four at a time with your favonte 
MBASIC or machine language keyboard game for HDOS. Program the response speed of the sticks, 
key sequence for different games, etc. Uses Atari joysticks. Only $25.00 

We fully support all of our independent-vendor products. If you have a question, we will never refer 
you to someone else. 

NEW PRODUCTS 


MODEMS 


BUFFERS 


Anchor Signalman Mark 1 

$95 

TTX 16K 

SI 60 

Anchor Signalman Mark XII 

S350 

TTX 64K 

250 

Novation D-Cat 

$189 

Quadram 16K 

175 

Novation Smart-Cat 103/212 

$550 



Volksmoden 

. $75 



SURGE SUPPRESSORS 


SWEET P 6-SHOOTER 

$895 

EPD: "Lime" 

$79 

PLOTTER 


EPD. "Orange" 

120 



Panamax SS4LCS 

95 



Panamax Maxi Strip 

35 




Printer Packages 

Our printer packages are fully checked out and set up for your system. All you need to do is plug it in 
and start using it! No more fussing with switch settings, making cables... the aggravation is gone! 
The package includes cable, assembled and tested, set up printer and your choice of HDOS or CP/M 
software. 

Dot Matrix Packages Include Cable and Software Daiseywheel Packages Include 

Gemini 10x $350 Cable And Software 

Prowriter 851 OAP+ 395 Silver Reed EXP 500 $500 

NEW Prowriter 8510 SP (180cps) 595 Silver Reed EXP 550 720 

NEW Prowriter 8510 BPI (IBM compatable) 480 NEW Silver Reed 400 395 

NEW Prowriter 8510 scp (color 180 cps) 690 C. Itoh A10-20 595 


Z-100/Z-150 Folks: Subtract $20 you don't need the software! 


As authorized ZDS dealers, we support the Heath/Zenith community with competitive prices and 
post sales support. Contact us for price and delivery on the Z system and accessories of your dreams. 

VA residents add 4% tax. Please add 3% or $2.00 minimum for shipping. Foreign orders in 
U.S. dollars or drawn on a U.S. bank. Also include customs house and address. 


Group purchase discounts are available-contact us for details 



H & H Computer Enterprises, Inc. 
P.0. Drawer H Blacksburg, VA 24060 
(703) 552-0599 
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program executed later will attempt to 
write over the area of memory reserved 
for the patches. 

A word of caution 

Remember that these patches will 
send to the printer whatever you send to 
the screen, including screen-formatting 
commands for graphics, reverse video, 
etc. If you run an application program 
after hitting the LINE FEED key, every¬ 
thing that program sends to the screen 
will also be sent to the printer. (And 
unless your program intercepts the LINE 
FEED key, you could set things off by 
accident.) 

Conclusion 

This endeavor into HDOS system pro¬ 
gramming not only resulted in a useful 
utility, but also gave me a greater under¬ 
standing of the internal operations of 
HDOS. I feel that relocating code into 
high memory is one of the best ways to 
extend the functionality of HDOS. 

I have already created other programs 
that install patches using the same idea. (I 
have one that compensates for a slight 
incompatibility between a ROM chip I 
purchased and the original H19 ROM. 
And I am working on a patch to allow 
designating any drive as the default.) 

The only problem is that too many 
patches will easily eat up available memo¬ 
ry. I have resolved this by putting each 
patch into a separate executable file and 
installing them only as necessary. A 


W FBE Cards For 
r .A H/Z-89 Computers 

SPOOLDISK™89 Electronic Disk & 
Printer Interface/Spooler- Micro¬ 
processor-based card with 128K of 
RAM acts like fast, quiet disk and 
also runs printer via Centronics 
Parallel interface (RS-232 available). 
Use for normal system printing or for 
spooled automatic printing. Installs 
on right-side bus. CP/M® and HDOS 
software included. RS232 $15 
SPOOLDISK™89 $195 
Parallel Printer Cable $24 

SLOT4 BUS EXTENDER -Adds 
fourth card slot to right-side bus. 

Easy installation with no permanent 
modifications. SLOT4 $47.50 

H89PIP PARALLEL INTERFACE- 
Two ports using 8255 PPI chip. One 
port bare and one port buffered for 
use as Centronics Parallel printer 
interface. Installs on left or right-side 
bus. CP/M® and HDOS printer driver 
software included. H89PIP $50 
Parallel Printer Cable $24 



FBE Research Company, Inc. 

P. O. Box 68234 
Seattle, WA 98168 
(206) 246-9815 

CP/M is a trademark of Digital Research Inc. 
VISA and MasterCard Accepted. 


Serial printers 


As noted in the body of the article, 
CODE.ASM is written for use with a 
parallel printer. Unfortunately, I do 
not have access to a serial printer 
or suitable technical information on 
which to base very solid recommenda¬ 
tions on modifying the listings given 
here. Working with the staff at 
Sextant , however, has produced some 
facts that may be helpful if you wish to 
use the program as is or modify it for 
serial operation. 

Testing FIX.ABS with serial printers 
(an H/Z25, and a Spinwriter con¬ 
figured as a Diablo) produced two 
problems. First, the entire system 
locked up as soon as the patches made 
any attempt to send a character to the 
printer. Later, when this problem had 
been corrected, characters were lost 
or garbled during transmission. 

Both problems appear to arise from 
the fact that the program talks to the 
printer directly through the input/ 
output (I/O) ports rather than through 
a device driver. (This makes the 
patches very device-dependent, but it 
lets me save memory by doing without 
a device driver.) 

If you use a serial printer, then, you 
may wish to consider either modifying 
the code or adopting a work-around. 

As noted, the patches initially 
would not work at all. Later, it was 
found that communication could be 
established if something had actually 
been sent to the printer through 
the printer driver. (Merely LOADing 
LP.DVD was not enough.) 

Apparently, the serial ports need to 
be initialized in some way (baud rate, 


parity, stop bits, or whatnot). If this is 
the case, then the initialization should 
be performed in LOAD, since that code 
executes only once and is not made 
resident. 

Also, printer status has to be taken 
into account. As you can see in Listing 
1, CODE both reads and writes to PORT 
(320Q). The system locked up, how¬ 
ever, when FIX was tried with the 
Spinwriter—even after the serial port 
had been initialized by copying a file 
to it. 

With the Spinwriter, a status port, 
PPORT, had to be specified—as shown 
in Listing la. 

With regard to dropping characters, 
both serial printers were presumably 
sending handshaking codes to the 
computer. In that case, the code 
would have to be modified to listen for 
and obey these codes. 

Here, the critical factor appears to 
be the terminal speed. Running FIX 
with a terminal speed of 300 baud 
produced perfect copy. (The H25 was 
running at 9600 baud, the Spinwriter 
at 1200.) 

Even if you have to work around 
Fix’s limitations, it may still prove 
valuable for those times when the 
lower terminal speed is not critical. It 
would certainly be advantageous, 
however, if you could modify the code 
itself to include both handshaking and 
initialization. If you have the source 
code for your printer driver, you 
should take a look at its initialization 
and character-output routines to see 
what sort of code you would need 
to add. 


PORT 

EQU 

340Q 

printer port 

MASK 

EQU 

3 00Q 

printer status mask 

PPORT 

EQU 

345Q 


READY 

EQU 

100Q 

printer ready status 

SPORT 

EQU 

355Q 

console status port 

SMASK 

EQU 

040Q 

console status mask 

DP0RT 

EQU 

350Q 

console data port 

WCCJD 

IN 

PPORT 

write character to printer as well 


Listing la. Substituting the PPORT EQU and other values given here will enable 
CODE.ASM to run with an H/Z25 serial printer. 


Wondering how many issues are left on your subscription? 

T22259 14.97 30638 23 JL 275 —>28 

The rightmost number in the top row of your address label indicates the last issue on 
your subscription. In the sample above, the last issue number is 28, indicating that the 
subscription ends with the May-June 1987 issue of Sextant. 
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FTL MODULA-2 $49.95! 

Don’t wait! If you like Pascal, you’ll love FTL Modula-2. Now available for 
Z80 CP/M and MSDOS computers for only $49.95! The built-in editor makes 
it fast and easy to use. Standard features include: ROMable code, 
coprocesses, system calls, assembler and linker. 

Special: Buy both FTL Modula and the Editor/ToolKit disk for only $79.95! 

The ToolKit contains full source to the FTL editor and several other important 
programs. 

“The best new CP/M compiler of 1985” —Jerry Pournelle, April 1986 Byte 


WRITE $99.95 

Revolutionize your word processing! write reads WordStar and Perfect Writer files, write pro¬ 
tects your text even against a system crash, write does underlining, boldface, proportional print, 
and on-screen trial printing that lets you experiment without paper. All edit commands are 
single-letter and changeable. Only $99! 


Workman and Associates Ask for our free catalog. More product information rushed on 
1925 East Mountain Street request. Please specify your format when ordering and add 

Pasadena, CA 91104 $3.00 for shipping. We welcome COD, Visa/MC orders. 

(818) 791-7979 
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T£MITH 


data 

systems 


COMPUTERS 

RAM Technology carries a full line of Zenith computers, peripherals, 
and software. Call us toll-free for competitive prices on systems and 
accessories. 


PRINTERS 

CANON LBP-8A1 Laser Printer. $2290.00 

CANON A40 NLQ Dot Matrix, 140 cps, QUIET. $ 279.00 

JUKI 6100 Daisy Wheel, 18 cps, parallel. $ 399.00 

JUKI 6300 Daisy Wheel, 40 cps, sor/par. $ 749.00 

OKIDATA ML182 Dot Matrix, 120 cps. $ 269.00 

OKIDATA ML192 Dot Matrix, 160 cps. $ 399.00 

TOSHIBA P321 3-in-1 par., 216 cps. $ 549.00 

TOSHIBA P341 3-in-1 par, wide carriage. $ 899.00 


Z200 UPGRADE ACCESSORIES 


VIDEO 


Video 7 EGA High-Resolution Color Card. $369.00 

NEC Multisync High Res. Color Monitor. $669.00 

Video 7 MGA High Res. Monochrome Graphics. $189.00 

Premier Technologies Z148 1 1 / 2 -Slot Board. $109.00 

ZVM-1220-A: Non-Glare, Amber Monitor. $ 99.00 

ZVM-1230-A: Non-Glare, Green Monitor . $ 99.00 

ZVM-1240: Non-Glare, Amber Monitor, TTL. $159.00 

ZVM-1200-1: Tilt Swivel Base . $ 17.00 

ZVM-1330: High-Resolution Color, RGB. $459.00 

ZVM-1360: High-Resolution Color, RGB, 

Long-Persistence Phosphor. $609.00 


INTEL ABOVE BOARD AT, 128K, 

Expandable to 2 MB. $459.00 

INTEL ABOVE BOARD AT PIGGYBACK, 128K; 

Expandable to 2 MB; Expands AB AT to 4 MB . $229.00 

SEAGATE ST4026 20MB, 40 ms. avg. $599.00 

SEAGATE ST4038 40MB, 40 ms. avg. $769.00 

SEAGATE ST4051 40MB, 40 ms. avg. $899.00 



Nashua 

TM 


Box of 10 With Lifetime Guarantee 


DYNAMIC RAM MEMORY 

4164 64K 150 NS.DRAM . QTY:1-50: $1.35 

41256 256K 150 NS.DRAM . QTY:1-50: $3.65 

41256 256K 120 NS. DRAM. QTY: 1-50: $3.98 


MODEMS 

EVERCOM INTERNAL MODEM, 300/1200 Baud. $179.00 

US ROBOTICS PASSWORD 300/1200 . $199.00 

US ROBOTICS MICROLINK 1200 W/Telpac. $239.00 

US ROBOTICS MICROLINK 2400 W/Telpac. $389.00 

US ROBOTICS COURIER 2400. $389.00 


PC COMPATIBLE UPGRADE ACCESSORIES 


HYPERCLOCK. Clock/Calendar and Software. $ 42.95 

INTEL ABOVE BOARD PC, 64K Expandable to 2 MB .. $299.00 

EVEREX MAGICCARD. $159.00 

NEC V20 8 MHz Processor. $ 14.95 

Z100 UPGRADE ACCESSORIES 

C.D.R.Z100 Speed Module. $ 39.95 

SOFTWARE WIZARDRY’S RAMPAL 100. $ 69.95 

FBE RESEARCH ZMF-100A: Install Up To 768K 

On Z100 Motherboards #181-4917 Or Lower. $ 59.95 

FBE RESEARCH ZCLK . $ 79.95 

ZENITH Clock/Calendar Module. $ 47.95 

SEAGATE 10 MB Winchester Kit, COMPLETE 

W/Zenith Contr, Hardware & Software . $ 999.00 

W/CDR Contr, Hardware & Software. $ 899.00 

SEAGATE 20 MB Winchester Kit, COMPLETE 

W/Zenith Contr, Hardware & Software . $1350.00 

W/CDR Contr, Hardware & Software. $ 999.00 


Nashua Diskettes: DS/DD, 48 TPI, Soft-Sectored 

or Hard-Sectored (Specify). $ 9 50 

Nashua Diskettes: DS/DD, 96 TPI, Soft-Sectored 

or Hard-Sectored (Specify). Special!. $21.50 

Nashua Diskettes: DS/High Density, Soft-Sectored, 

600 Oersted Media for IBM AT and Compatible 

1.2 MB Disk Drives. Special! . $29.95 

HARD DISK DRIVES 

SEAGATE 20 MB Hard Disk with 

OMTI Controller. $469.00 

SEAGATE 10 MB Hard Disk With OMTI. $399.00 

SYQUEST 10 MB Removeable Media Hard Disk 
Drive With OMTI Controller, Mounting 

Hardware, Cables and One Cartridge. $799.00 

Additional Cartridges. $125.00 

MITSUBISHI DISK DRIVES 

MF501A: 5V4" HalfHeight, 48 TPI, DS/DD. $125.00 

MF503A: 5V4" Half Height, 96 TPI, DS/DD. $149.00 

MF504A: 5Va" Half Height, 96 TPI, 1.2 MB 

Z200/IBM AT Compatible. $159.00 

M2896: 8” Half Height, 48 TPI, DS/DD, 

Shugart 850/860 Compatible . $399.00 


TERMS 

Prices and specifications subject to change. Minimum 90-day war¬ 
ranty on all hardware. Personal checks held 10 working days; 
money orders accepted as cash. COD orders accepted; cash or 
cashier’s check only. VISA/MC accepted; please add 2.8%. Pur¬ 
chase Orders accepted from businesses and educational institu¬ 
tions. User group inquiries invited. We appreciate your business!. 



RAM Technology 

427-3 AMHERST STREET, SUITE 265 
NASHUA, NEW HAMPSHIRE 03063 

1-800-662-0070 

In Alaska and New Hampshire: (603) 889-0633 


HOURS OF OPERATION: Monday-Friday, 9:00 A.M. - 5:00 p.m. EST 
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Play Apples and Floors 
on Your '100 

The numeric keypad guides Happy Harry as he tries to evade the Big Mouth 
Meanies and other hazards. 

Robert E. Marler 


Several years ago, I enjoyed a game 
called Ladders. It was written by Jerry 
Phelps, and it ran on the H/Z89. I was 
happy when I learned that a new version 
of this game—now called Apples and 
Floors—was available for the Z100. 

This is an arcade-type game using color 
and some of the graphics capabilities of 
the Z100; it works best on a color monitor, 
but can be used on a monochrome 
monitor. 

Five floors 

When you start the game, the screen 
display shows five floors. The floors are 
connected by ladders and a transporter, 
and there are a total of twelve apples 
hanging from the ceilings. 

The chief “character” in this game is 
Happy Harry. Harry’s movement is con¬ 
trolled by the numeric keypad; he can 
walk and jump, and move from floor to 
floor. 

Harry has to evade the Big Mouth 
Meanies, who are hunting him. (And 
there are various other hazards which 
will appear from time to time later in the 
game.) 

Harry also has to rescue the prisoner 
who is pacing in his cell in the upper 
left-hand corner of the screen. There is a 
rocket aimed at the prisoner, with a flame 
advancing toward the rocket. If the rocket 
ignites, the prisoner dies and the game 
ends. 

Happy Harry wins points by jumping 
up and biting the hanging apples. Each 
time Happy Harry wins points, the score 
is updated and the flame returns to its 
starting point. In addition, each time 
Harry scores, he becomes “hot” for a 
short period; while hot, he can capture 
Big Mouth Meanies for additional points. 

If Harry bumps an apple with the top of 
his head when he jumps to eat it, he will 
be destroyed. 

You start the game with five Happy 
Harries available; an additional Harry is 


Robert E. Marler works as a sales 
engineer for pneumatic control devices. 
His hobbies include camping, boating, 
gardening, and computing. 


awarded at the successful completion of 
each screen, and for every 10,000 points 
scored. If you lose all your Happy 
Harries, of course, the game ends. 

Four screens 

The first screen is completed when 
Harry has successfully eaten all the 
apples. (There are four different screens, 
each at a higher level of difficulty.) Before 
each new screen, there is an “intermis¬ 
sion” with a fireworks display, or a cartoon 
where a warrior comes out and saves the 
prisoner. 

In the second screen, there are three 
ponds, which Harry can cross only by 
jumping up and grabbing a swinging vine 
at the proper time. And besides apples to 
eat, there are now spots on the floors that 
he must step on to win points—but after 
they’re stepped on, the spots turn into 
dangerous holes that Harry has to jump 
over. 

The third screen has additional 
hazards—trolls and snakes—which travel 
across the floor at random times. There’s 
also a vertical lift which Harry can use to 
move from floor to floor—if he can suc¬ 
cessfully jump on and off the lift. 

The fourth screen has horizontally and 
vertically moving floor segments. Harry 
must negotiate them to eat all the apples 
and step on all the spots. And now he has 
to avoid a randomly appearing bouncing 
ball. 

Harry is killed if he steps into a hole or 
falls into a pond while swinging across on 
a vine. Being hit by any of the various 
hazards will also do him in. 

After successful completion of all four 
screens, you can start all over again at a 
higher level of difficulty. The game runs 
faster, the Meanies return to the screen 
more quickly after being captured, Harry 
is “hot” for a shorter time, and the flame 
advances to the fuse more quickly. 

And variety 

I found the animation and graphics to 
be superb. The author could have used 
the Z 100’s standard block-graphics char¬ 
acters, similar to the graphics-character 
set on the H/Z89. Instead, he modified 


the display of the regular character set in 
order to design a custom block-graphics 
set. The result is comparable to the 
graphics used in arcade games. Harry has 
eyes, ears, a nose, and a mouth; and the 
Meanies’ mouths are constantly chomp¬ 
ing at Harry, hoping to devour him. 

The game is random, with no two the 
same. The high score is written to a file on 
the disk and displayed each game. A new 
high score updates the file. The game is 
varied enough, and difficult enough, to 
hold your interest for many hours; it is 
well worth the modest cost. 

At the beginning of the game, you can 
choose color or monochrome; if your TOO 
has 64-kilobit video-memory chips and 
you want a display made up of twice as 
many dots, you can choose interlace 
mode. Also, there is a pause control to 
stop and restart the game at any time. 

Apples and Floors will run on a Z100 
with 128 kilobytes of memory, and is 
available on a 5 1 // double-sided/double¬ 
density, soft-sectored, 48-track-per-inch 
disk. It runs under either CP/M-86 or the 
Microsoft Disk Operating System (and 
the Zenith Disk Operating System). 

The original Z-DOS/MS-DOS version 
of Apples and Floors used a special 
ALTCHAR. SYS file to hold the custom 
graphics characters. And you had to re¬ 
boot in order to get rid of the custom 
characters. 

The current version of the game for 
Z-DOS/MS-DOS does not require the 
custom ALTCHAR. SYS, however. It 
automatically loads the custom graphics 
at the beginning of the game and restores 
the standard character set at the end of 
the game. The new version also allows 
the high-score file to reside on any 
drive— A:, B:, C:, D:, E:, or F:. 

Ordering Information 

Apples and Floors, $27.50 (includes 
U.S. shipping). Specify operating 
system. 

Jerry A. Phelps 
Bit-by-Bit 

6013 Innes Trace Road 

Louisville, KY 40222 

502/425-4765 evenings A 
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A full year for only $18. 

Jv hink about it, a full year of technical and useful infor- 
Pilmation about C. The C Journal provides program¬ 
ming information for any machine - IBM PC™, UNIX™ 
-based, Macintosh™, or CP/M™ - micro, mini or main¬ 
frame. Look forward to each issue for: 

—NEW in-depth reviews and feature articles - C 
compilers, editors, interpreters, function libraries 
and books. 

— NEW efficiency hints and tips. 

— NEW interviews with C experts. 

— NEW news and rumors from the ANSI standards 
committee and industry. 

■ ubscribe today to the only magazine that is dedi- 
_Jcated specifically to C - The C Journal. 

Please send check or money order for $18 
(cover price $28) to: 


IlnfoPro Systems 


PO Box 849, Denville, NJ 07834 
Call TOLL FREE (800) 628-2828 ext. 849 
(for charge card orders only) 


theC 




Small C: Interview with Ron fil» 

A Tale of Three EMACS 
Catching Common C Bog* 

Brace Hunter The UNIX Environment 
More MS-DOS Library Review* 

Tom Plum: ANSI C Report 


Please add $9 for overseas mall and $6 for Canadian subscriptions. 


— "" """ ™ 






; : 


THE C JOURNAL' 



Trademarks - IBM PC: IBM Corp.; UNIX: AT&T Bell Labs; Macintosh: Apple Computer Corp.; CP/M: Digital Research Inc.; The C Journal: InfoPro Systems. 
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A C Utility that Does 
More than print 

Also less. Use it when you want your listings to have line numbers. 


Anthony F. Herbst 


The PRINT utility that comes with the 
Zenith Disk Operating System (Z-DOS) 
is functional, but it suffers from several 
deficiencies. Mainly, it does not provide 
for optional line numbering, for time and 
date stamping, or for printer setup. 

When I needed listings with line 
numbers while debugging a lengthy C 
program, those shortcomings led me to 
write a short program in the C language. 
The program, which I call clist2, accom¬ 
panies this text as Listing 1. 

For this article, I am assuming that 
readers have an intermediate level of 
programming knowledge. (You may still 
want to follow along even if you’re just 
starting out, but I think you may also want 
to look at something like Joseph Katz’s “C 
Notes” column in this and previous issues 
of Sextant.) 

clist2 is a C program that can be used 
to list any ASCII file. It was written for 
the Computer Innovations C86 compiler; 
but it should compile with C/80 from The 
Software Toolworks with little modifica¬ 
tion beyond elimination of the time and 
date functions. 

For clist2’s functional time and date 
routines, I owe much to the staff at Com¬ 
puter Innovations for helping me when I 
ran into difficulty. C86 has become my 
favorite C package because of willing 
support like this, combined with a gener¬ 
ous update policy and a compiler that 
produces .EXE files that I’ve run without 
problems on ZlOOs, IBM Personal Com¬ 
puters, Wang PCs, Mindsets, etc. 

clist2 serves as an example of some of 
the features available in C. These include 
passing the name of the file to be listed as 
a command-line argument and optional 
command-line switches to print line 
numbers or switch the printer to corre¬ 
spondence quality. (My printer is an 
Okidata 92. Other printers will generally 
require different setup codes.) 


Anthony Herbst is a professor of 
finance in the Roy E. Crummer 
Graduate School of Business at Rollins 
College in Winter Park , Florida. He 
has written several programs for 
capital-investment analysis. 


As it is shown in Listing 1, clist2 has 
line numbers. Those not familiar with C 
should note that these are provided solely 
for the reader’s convenience. C does not 
use line numbers, and their inclusion 
would prevent the compiler from work¬ 
ing. With this said, it will be instructive 
to examine the program to see what 
it does. 

The heart of the program 
Line 1 causes the compiler to include 
C86’s stdio.h file in order to insert defini¬ 
tions of standard Z100 input/output (I/O) 
parameters. 

Lines 2 and 3 define page length and 
maximum line length. These are some- 

clist2 serves as 
an example of some 
of the features 
available in C. 

what arbitrary and may be changed to suit 
individual needs or preferences. Lines 5 
through 10 illustrate a comment—any¬ 
thing contained between /* and */. Line 4 
is a blank line (i.e., just a carriage return/ 
line feed). 

As I have set it up, Line 11 is the first 
line in the program per se. Think of a 
program in C as being a collection of 
functions. In general, the functions are 
named by the programmer. There is one 
special name, however— main —which is 
the starting point for program execution 
in any C program; other functions can be 
called from within main. 

main can take two arguments: argc 
and argv. These are defined by the C 
environment. The number of command¬ 
line arguments with which the program 
was invoked is stored in argc. argv is a 
pointer to an array containing those 
arguments. (Adequate discussion of 
pointers is beyond the scope of this arti¬ 
cle. Any one of several texts on C 
programming may be consulted for a full 
explanation.) 


Looking again at line 11, you will see 
that I have defined my main function to 
accept both argc and argv as param¬ 
eters. In line 12, argc is declared an 
integer. In line 13, argv is declared a 
pointer to an array of characters. Note 
that the type of the array depends on the 
type of command-line arguments—in 
this case, they are of type character. 

How does all this work in practice? 
Suppose we wanted to invoke clist2 to 
print a file named FILE.TXT, with line 
numbers, and in correspondence quality. 
On the command line we would type: 
clist2 FILE.TXT -n -C 

(or equivalently, clist2 FILE.TXT -nc). 
argv[0] would contain the character 
string clist2, argv[l] would contain 
FILE.TXT, argv[2] would contain n, and 
argv[3] would contain c. The value of 
argc would be 4. Note that in the C 
language, unlike BASIC and FORTRAN, 
brackets “[” and “]”, not parentheses, are 
used to denote array elements. 

Line 14 contains the left brace (i.e., 
“curly bracket”) that defines the start of 
the program code for clist2.c. Note that 
argc and argv were defined outside of 
the main program body because they are 
parameters whose values are provided 
from “outside”—i.e., from the command 
line. 

(While the maximum size of argv may 
vary from one compiler to another, it is 
generally large. So, when you invoke a 
program, you can pass a large number of 
arguments to it on the command line.) 

Line 15 defines variable c as an array of 
MAXLINE characters. Remember MAXLINE 
from line 3? It was defined as 257. The 
compiler preprocessor automatically 
makes the replacement. 

Lines 16 and 17 provide other variable 
definitions. NULL is predefined in the 
stdio.h that was #included. You may 
wish to think of it as meaning “false.” Line 
18 defines file variables. 

Line 20 is equivalent to stating argv = 
argv + 1 , but is more succinct. 

Line 23 tests whether there are fewer 
than two arguments. If there are, the user 
has not provided the name of a file to list. 
In this case, an informative message is 
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printed and an exit made from the 
program back to the operating system. 
Line 28 ends this section of the program. 

Line 30 is a case of combining an oper¬ 
ation and a test in C. The variable ptr is 
set to the value returned by the function 
fopen; fopen opens the file name con¬ 
tained in the location pointed to by *argv 
in ASCII read mode. If the value 
returned by fopen is NULL (indicating a 
failure to open the file), an appropriate 
message is printed. 

The \n specifies that a “newline” be 
printed. Note that a single equal sign (=) 
denotes assignment; a double equal sign 
(==) denotes a test of equivalence. 

Lines 35 through 38 perform an opera¬ 
tion analogous to lines 30 through 35. 
This time, the operation is performed on 
the printer, opening it as a file in write 
mode. 

Lines 42-50 contain the statements re¬ 
quired for interpreting the optional 
command-line switches. Note that lower¬ 
case n and c are expected. You may wish 
to be allowed to use the uppercase N and 
C on the command line. If so, you must 
provide the appropriate switches by add¬ 
ing lines equivalent to 45 and 46. 

(For a clear and concise explanation of 
this section of code, see Kernighan and 
Ritchie, The C Programming Language , 
Prentice Hall, 1978, pages 110-114. This 
book is the definitive reference to C.) 

Lines 54 through 112 contain the 
program code for reading and printing 
the specified file line by line. Line 54 
initializes the page counter to 0. Lines 
56-60 send octal setup characters to the 
printer. Lines 62 and 63 call date and time 
functions. The ampersands (&) indicate 
the addresses where the values are to be 
stored. For example, &year is the ad¬ 
dress of the variable year. 

Line 65 specifies an endless loop. It is 
exited only when an end-of-file is 
encountered in the input file (or the user 
enters a CTRL-C at the keyboard). 


Z-IOO USERS S 

Great Prices on Outstanding Z-100 Products 

CDR 

I •Hard Disk Systems 10, 20 or 40 MB 

FBE Research 

•ZCLK: On Line Time & Date 
•ZMF100A: 768K on Old Motherboard 
•ZRAM-205: Z205 Memory Card Upgrade 

UCI 

•Easy PC: IBM Emulation 
•Memory Card with RAMDRIVE: Up to 2 MB 
'•Easy I/O: 2 IBM Ports, Clock, Game Port 
^^•Easy I/O Plus: ZPC Serial Port Board 
•Easy 87: 8087 Co-processor 

Zenith 

•Standard or Custom PC Compatibles 

IC’s 

j *V20, 8088, 8087, 64K & 256K DRAMS 


\ 


Lightek ( 216 ) 673-5358 | 

P.O. BOX 6493 KENT, OHIO 44240 A 
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Listing 1. clist2.c allows you to send setup codes to your printer, and to print your files with 
optional line numbering, and time and date stamping. (The line numbering which appears 
here is not part of the program file.) 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 


^include "stdio.h" 

^define PL 55 /* page length */ 

^define MAXLINE 257 

/* program clist2.c 

Copyright (c) 1984 by Anthony F. Herbst. All rights reserved. 
Permission to copy for non-commercial use granted. 

•/ 

main(argc,argv) 
int argc; 
char *argv[]; 

{ 

char c[MAXLINE] ,*pfile,*sw; 

int i,j,k,page=0,date(),time(),year,month,day,line__nums=NULL; 
int corresp_qual=NULL,hours,minutes,seconds; 

FILE *fopen(),*ptr,*ptr1; 

argv += 1; /* increment pointer by 1 •/ 

pfile=argv; /* save address of argv[1] */ 

if(argc<2) { 

printf( n \n\nProgram usage: clist2 filename.ext <-nc>\n\n"); 
printf(" n => print line numbers on each line\n n ); 
printf(" c => correspondence quality printing\n\n"); 
exit(); 

} 

if((ptr=fopen(*argv, n r n ))==NULL) { 

printf("\n\nCannot open specified file."); 
exit(); 

} 

if((ptr1=fopen("PRN:","w"))==NULL) { 

printf("\n\nCannot open printer (PRN: on ZDOS)."); 
exit(); 

} 

/* examine command line options and set switches */ 

while(—argc>1 && (*++argv)[0]==»-’) 

for(sw=argv[0]+1; *sw != f \0’ ; sw++) 
switch(*sw) { 

case ’n’: line_nums=1; break; 
case ’c’: corresp_qual=1; break; 

default: printf("\n\nFound illegal option -$c\n", *sw); 
argc=0; 
break; 

} 


/* end of option examination •/ 


putc( , \034’,ptr1); /* set Okidata printer to 12 char./inch */ 

if(corresp_qual) { 
putc(*\033 * »ptr1); 
putc(’\06l 1 ,ptr1); 


date(&year,&month,&day); 
time(&hours,&minutes,&seconds); 

for(;;) { /• start infinite loop here •/ 

if((i$PL)==0) { 
page++; 

if(i!=0) fprintf(ptr1,"\f"); 

fprintf(ptrl,"\n Listing for: $13s ", *pfile); 

fprintf(ptr1at $02d:$02d:$02d on $4d-$02d-£02d ....", \ 
hours,minutes,seconds,year,month,day); 
fprintf(ptr1 ,".Page ?3d\n" ,page); 

} 

j=0; 

while(c[j]=getc(ptr)) { 
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79 


if(j>MAXLINE) { 

80 


printf("\n\nLine longer than $4d encountered! n ,MAXLINE); 

81 


exit(); 

82 


} 

83 



84 


if(e[j]==E0F) { 

85 


fprintf(ptrl,"\f"); /• eject page after file printed »/ 

86 


exit(); 

87 


} 

88 



89 


if(e[j]=='\n') { 

90 


if(line nums) { 

91 


fprintf(ptr1,"\n $9d n ,++i); 

92 


} 

93 


else { 

94 


fprintf(ptrl ,"\n n ); 

95 


++i; 

96 


} 

97 



98 


for (k=0;k<=j;k++) { 

99 


if(c[k]=='\n f ) goto xwhile;/»at end of line exit while*/ 

100 


putc(c[k] ,ptr1); 

101 


} 

102 



103 


} 

104 



105 


j++; /* increment for character count on the line */ 

106 



107 


} /* end of while range •/ 

108 



109 


xwhile: /* this label is target for a "goto" •/ 

110 


j=0; /* reinitialize j before going through while loop again •/ 

111 



112 


} /* end infinite loop */ 

113 



114 

} 


115 



116 

int date(year,month,day) 

117 


int *year,•month,*day; 

118 

{ 


119 


int sysint21(); 

120 



121 


struct regval { int ax,bx,cx,dx,si,di,ds,es; } ; 

122 


struct regval sreg; 

123 


struct regval rreg; 

124 



125 


sreg.ax=0x2a00; 

126 



127 


rreg.cx=0x0000; 

128 


rreg.dx=0x0000; 

129 



130 


sysint21(&sreg,&rreg); /* system function call */ 

131 



132 


•year = rreg.cx & 0xffff; 

133 


•month = rreg.dx » 8; 

134 


•day = rreg.dx & 0x00ff; 

135 



136 


return; 

137 

} 


138 



139 

int time(hours,minutes,seconds) 

140 


int *hours,•minutes,*seconds; 

141 

{ 


142 


int sysint21(); 

143 



144 


struct regval { int ax,bx,cx,dx,si,di,ds,es; } ; 

145 


struct regval sreg; 

146 


struct regval rreg; 

147 



148 


sreg.ax=0x2c00; 

149 



150 


rreg.cx=0x0000; 

151 


rreg.dx=0x0000; 

152 



153 


sysint21(&sreg,&rreg); /* system function call •/ 

154 



155 


•hours = rreg.cx »8; 

156 


•minutes = rreg.cx & 0x00ff; 

157 


•seconds = rreg.dx » 8; 

158 



159 


return; 

160 



161 

} 



The remainder of the program 

The rest of the program statements are 
self-documented. The notation + + i or 
k++ increments the variable i or k by 
one, with i incremented before the 
corresponding operation, and k in¬ 
cremented afterward. 

The date and time functions contained 
in lines 116 through 161 are offered 
without comment. Discussing them 
would get too much into the question of 
interfacing C to the operating system. 
They both use the function sysint21 
provided with the C86 compiler for 
performing interrupt 21 to call MS-DOS 
system services. 

As a convenience to interested readers, 
the compiled program as it is shown can 
be obtained from the author for $9, if you 
supply a formatted disk (Z-DOS or MS- 
DOS version 2) and a cardboard mailer; 
or for $12 otherwise. 

For compilation with setup codes for 
other printers add $10, and be certain to 
specify whether you are providing the 
octal or hexadecimal values required. 
Permission to copy the program for non¬ 
commercial purposes is granted. 


Ordering Information 

Anthony Herbst 
2451 McIntosh Way 
Maitland, FL 32751 

C86 C compiler, Version 2.3, $395. 
Computer Innovations, Inc. 

980 Shrewsbury Avenue 
Tinton Falls, NJ 07724 
800/922-0169 or 201/542-5920 

C/80 (CP/M), $49.95. 

The Software Toolworks 
9713 Santa Monica Blvd., Suite 204 
Beverly Hills, CA 90210 
800/223-8665; in California, 
800/228-8665 A 


Improved Graphics for 

H19 & H89 

(also H19A & H89A) 

G-Prom is a new character 
generator that: 

• Improves screen graphics 
resolution 2% times. 

• Improves formation of 23 
ASCII characters. 

• Is a plug-in replacement 
for the original C.G. ROM. 

Only $19.95 with shipping, 
documentation, instructions, 
and demo program listing. 

NORCOM 

9630 Hayes 

Overland Park, KS 66212 
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ONE MILLION DOLLAR 
ZENITH SOFTWARE SALE 

SUDDENLY HEATH/ZENITH SOFTWARE 
IS MORE THAN A BARGAIN. HERE'S WHY_ 


Payload Computer Services purchased over one million dollars of Zenith software from one of America's largest corporations. We have been 
running this sale for several months now and sales have been quite good, but to sell a million dollars worth takes time. With sales of $10,000 per 
week it would take about two years. We feel it is time to clear our warehouses to make room for other Zenith equipment. With that goal in mind we 
are making further price cuts to almost give-away prices. All packages shipped complete with manuals and registration cards. MAIL or PHONE 
your order today and expect prompt service. MASTERCARD and VISA gladly accepted with no additional charge. 


PART 

ZENITH SOFTWARE FOR THE 
Z100 SERIES COMPUTERS 

LIST 

SALE 

NUMBER 

DESCRIPTION 

PRICE 

PRICE 

MS-463-1 

Z-BASIC (16-bit) 

$175.00 

$24.00 

MS-463-7 

interpreter 

Multiplan 

$195.00 

$24.00 

CB-463-11 

Z-Chart 

$150.00 

$15.00 

CD-463-2 

Condor File Manager 

$299.00 

$24.00 

PK-100-4 

All 4 listed above 

$819.00 

$62.00 

MP-463-3 

MailMerge for Word¬ 

$135.00 

$18.00 

MP-463-11 

Star v3.21 

MailMerge for Word¬ 

$249.00 

$45.00 

MS-253-1 

Star v3.3 

Microsoft BASIC-80 

$175.00 

$24.00 

OS-53-2 

(8-bit) 

CP/M-85 (8-bit) 

$150.00 

$24.00 

OS-63-4 

Z-DOS 

$150.00 

$35.00 

CB-463-7 

CPS Computerized 

$ 40.00 

$18.00 

CB-463-9 

Phone System 

PECON Peachtree to 

$ 99.00 

$15.00 

ES-463-1 

Condor 

Microstat 

$249.00 

SOLD 

RS-463-1 

Peachtree General 

$399.00 

$64.00 

RS-463-2 

Ledger 

Peachtree Accounts 

$399.00 

SOLD 

RS-463-3 

Receivable 

Peachtree Accounts 

$399.00 

SOLD 

RS-463-5 

Payable 

Peachtree Inventory 

$499.00 

$64.00 

RS-463-75 

Management 

PeachText 5000 

$395.00 

$77.00 

SC-463-1 

SuperCalc 

$195.00 

$45.00 

TA-463-1 

ZDS Teacher Program 

$295.00 

$55.00 

TA-463-2 

ZDS Student Program 

$100.00 

$20.00 

WI-463-1 

Remote Batch 

$899.00 

$48.00 

PO-463-1 

Terminal Emulator 

3270 IBM Emulator 

$650.00 

$48.00 


INTERNAL DUAL DRIVE SETUPS FOR H/Z89 
COMPUTERS 

Includes two half-height double-sided disk drives and all hardware 
and connectors required to mount inside your H89. Steel mounting 
shield/case included. 

NATIONAL JA551-2 Setup, 48 TPI, 6 MS seek, 320K disks ...$299.00 
MITSUBISHI MF501 Setup, 48 TPI, 6 MS seek, 320K disks....$312.00 


MITSUBISHI 4853 Setup, 96 TPI, 3 MS seek, 640K disks.$319.00 

HALF-HEIGHT FLOPPY & HARD DISK DRIVES 

MITSUBISHI M2896 8" DS, DD, 48 TPI .$375.00 

NATIONAL JA551-2 5.25" 320/360K, 48 TPI.$122.00 

MITSUBISHI MF501 5.25" 320/360K, 48 TPI.$124.00 

MITSUBISHI M4853 5.25" 640K, 96 TPI.$130.00 

MITSUBISHI M4854 5.25" H.D. 1.2-MEG.$177.00 

SEAGATE ST-225 20-MEG Winchester 

Hard Disk.$377.00 

SEAGATE ST-238 30-MEG Winchester 
Hard Disk.$395.00 


We have high speed high capacity hard disk drives available for the 
Z200 AT-compatible computers. Please write or call for lowest price. 


ZENITH SOFTWARE FOR THE 
H/Z89 SERIES COMPUTERS 


PART 


LIST 

SALE 

NUMBER 

DESCRIPTION 

PRICE 

PRICE 

HES-837-1 

Microstat (96 TPI) 

$249.00 

$40.00 

HMP-837-1 

SuperSort 

$195.00 

$40.00 

HCP-837-1 

Pearl #3 Program 
Generator (96 TPI, 
requires C-BASIC) 

$450.00 

$40.00 


ZENITH MONITORS 

ZVM-1360 Long Persistence 13" High Res.$586.00 

ZVM-1330 Color 13" High Res., RGB only.$437.00 

ZVM-1220 Amber Non-Glare Flat Screen .$119.00 

ZVM-1230 Green Non-Glare Flat Screen .$119.00 

ZVM-1240 Amber Flat Screen TTL input .$188.00 

VIDEO CARDS 

Z-171-3 Z-171 Video Card RGB/Comp.$189.00 

Z-329 High-Resolution Monochrome for Z-138, 148, 151, 158, 

200 computers.$182.00 

Z-409 Color Graphics/Monochrome for Z200.$205.00 

TE-37 Tecmar Graphics Master .$482.00 

400-L/H Sigma Hi-Res Color . $511.00 


UPGRADE ACCESSORIES FOR H/Z89 
COMPUTERS 

MAGNOLIA MICROSYSTEMS DOUBLE-DENSITY CONTROLLER. 

Soft-sectored disk controller. Supports up to four each 5.25" and 8" disk 
drives. Complete with cables, installation instructions and CP/M 

2.242.$294.00 

MAGNOLIA MICROSYSTEMS MEMORY UPGRADE CARD. In 

stalls in your H89 to increase memory from 48K to 64K.$50.00 

MAGNOLIA MICROSYSTEMS SASI BUS I/O. Use to connect 
Winchester disk drives to your H89. Also has three serial ports. Software 

included.$175.00 

WINCHESTER HARD DISK DRIVE SET-UP. Includes 20-MEG hard 
disk drive, SASI interface, power supply and case with fan, cables, hard 
disk controller and CP/M software.$1095.00 

ZENITH IBM COMPATIBLE COMPUTERS 

ZF-158-41 One 360K floppy disk drive, 256K RAM, color ready. 

Retail $1999.00, Payload.$1394.00 

ZF-158-42 As above with two floppy disk drives and 256K RAM. 

Retail $2199.00, Payload.$1519.00 

ZW-158-42 As above but with 20-MEG Winchester drive and one 

floppy diskdrive. Retail $2799.00, Payload.$2040.00 

ZFL-171-42 PORTABLE Backlighted 25-line X 80-column LCD 
screen, 256K RAM, two 1 /3-height 360K disk drives, ROM-based 

software, approx. 14.3 lbs. Retail $2399.00, Payload.$1663.00 

ZFL-241-81 Z200 Computer, AT compatible with one 1.2-MEG 
floppy diskdrive, 512K RAM. Retail $3499.00, Payload ....$2534.00. 
Requires Z-329 or Z-409 Video Card listed below. 

ZW-241-82 Z200 Computer, AT compatible with one 1.2-MEG 
floppy disk drive, one 20-MEG high speed hard disk drive, 512K 

RAM. Retail $4499.00, Payload.$3144.00. 

Requires Z-329 or Z-409 Video Card listed below. 

All above come with MS-DOS supplied by Zenith. When 
comparing prices, remember, Payload charges only $5.00 for 
shipping of prepaid orders. We can enhance the above computers 
with more memory or larger Winchester drives at low costs to you. 
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ZENITH SOFTWARE FOR 
THE Z150/160 SERIES COMPUTERS 


PART 

NUMBER 

DESCRIPTION 

LIST 

PRICE 

SALE 

PRICE 

MS-5063-7 

Multiplan 

$195.00 

SOLD 

RS-463-75 

PeachText 5000 

$395.00 

$ 77.00 

BP-5063-1 

BPI General 

$595.00 

SOLD 

BP-5063-2 

Accounting 

BPI Accounts 

$595.00 

$ 95.00 

BP-5063-3 

Receivable 

BPI Accounts 

$595.00 

$ 95.00 

BP-5063-4 

Payable 

BPI Payroll 

$595.00 

SOLD 

BP-5063-5 

BPI Inventory 

$795.00 

SOLD 

BP-5063-6 

BPI Job Costing 

$795.00 

SOLD 

BP-5063-71 

BPI Series Self- 

$ 69.00 

$ 25.00 

BP-5063-8 

Training 

BPI Personal 

$195.00 

$ 55.00 


Accounting 


EIGHT-INCH DISK DRIVE SYSTEM 

Two Mitsubishi 8" half-height, double-density, double-sided drives in 
deluxe cabinet with heavy duty power supply and cooling fan, 2.4-MEG 
storage total. Plug into H/Z89 equipped with Magnolia DD controller or 
any H/Z100 computer.$977.00 


UPGRADE ACCESSORIES FOR Z150/160 SERIES 
COMPUTERS 

CLOCK CARD Keeps time and date, and supplied software enters 

time/date at boot-up.$44.00 

MEMORY KIT #150-256-18. Includes a ZPAL chip which allows use of 
the new 256K RAM chips included (18 pieces 256K 150 ns RAM chips). 
Kit increases 128K memory to 640K. If you have over 128K now, will go 
up to 704K. All plug into your single Zenith memory board. Unbeliev¬ 
able but true.$94.00 

WINCHESTER HARD DISK DRIVE INTERNAL SET-UP. Includes 
Winchester drive, controller/interface card, cables and all hardware. 

With 20-MEG (formatted) drive. $495.00. 

May be installed in Z138/148 using an Expansion Card sold below. 
PTZ-148 EXPANSION CARD for Z148. Includes 2 expansion slots plus 

a clock/calender.$129.00 

Z-130-1 EXPANSION CARD for Z138, one expansion slot.$94.00 

WINCHESTER HARD DISK DRIVE EXTERNAL SET-UP. Includes 
Winchester drive, controller/interface card, power supply and case with 

fan. With 20-MEG (formatted) drive.$695.00 

8087-3 NUMERIC CO-PROCESSOR CHIP. Speeds and improves 

numeric processing.$129.00 

8-MEG 8087-2.$165.00 

SECOND INTERNAL DISK DRIVE. Includes instructions and all 

mounting hardware. If you have a Shugart drive (has rotating lever 

latch).$122.00 

If your drive is a Mitsubishi (has flat up/down latch).$127.00 


POWER SUPPLIES AND CASES FOR DISK DRIVES 

Rugged steel construction with heavy duty power supplies. Purchase 
with drives and we will install drives in case. 


Single 5.25" unit for full-height drive.$ 68.00 

Dual 5.25" unit, specify full- or half-height.$ 92.00 

Dual 8" unit with fan, for half-height drives.$225.00 

Face plate for single drive in dual case.$ 8.00 

For Winchester drive, with fan.$205.00 


RAM CHIP SPECIALS 

The finest available and at PAYLOAD prices. Order one to one thousand 
and add only $2.00 for shipping. For quantity orders, please call for 


latest pricing. 

64K Dynamic RAM, 150 ns.$1.40 each 

256K Dynamic RAM, 150 ns.$3.48 each 

256K Dynamic RAM, 120 ns.$3.78 each 


V-20 CHIPS 

We have the high speed NEC V-20-8 8088 replacement chips. These 
run at up to 8 MEG and are said to increase CPU speed 10- 
30%.$14.75. 


TOSHIBA PRINTERS 

The new generation printers are here. The Toshiba 3-in-1 printers offer 
high speed draft quality, near letter quality and high-resolution qraphics 
using an advanced 24-pin dot matrix print head. Choice of serial or 
parallel interface. 

RETAIL PAYLOAD 


P-321-P Parallel.$ 699.00 $ 539.00 

P-321-PS Parallel and Serial interfaces.$ 749.00 $ 577.00 

P-341-P Parallel Wide Carriage.$1099.00 $ 837.00 

P-341-PS Parallel & Serial, Wide Carriage.$1149.00 $1140.00 


Other Toshiba printers and accessories available. 


UPGRADE ACCESSORIES FOR Z100 SERIES 
COMPUTERS 

COLOR GRAPHICS UPGRADE. All memory chips (16 pieces 150 ns) 
required to update Z100 series computer for color. Installation in¬ 
structions included. Order Memory Kit #100-64-16.$25.75 

complete 

MEMORY UPGRADE. All memory chips (9 pieces 150 ns) required to 
upgrade from 128K to 192K RAM. Installation instructions included. 

Order Memory Kit #100-64-9.$14.50 

ZMF100A BY FBE RESEARCH. A modification package which allows 
256K chips to be used on the old-style motherboard to reach 768K. 
Simple assembly with no soldering or trace cutting. Compatible with 

EasyPC and Gemini Emulator.$60.00 

With 27 256K RAM chips included.$154.00 

UCI EASYPC. IBM PC emulator. Makes your Z100 IBM-software 
compatible. Full 8-MEG operation, color graphics and audio compat¬ 
ible. Retail $699.00 Payload.$492.00 

UCI EASYPC 8087 NUMERIC CO-PROCESSOR. New add-on for 

EasyPC.$69.00 

GEMINI EMULATOR BOARD. Makes the Z100 compatible with the 

IBM PC library of programs.$469.00 

UCI MEMORY UPGRADE CARD. We recommend this one highly. 
The board has sockets for up to 2 MEG of memory RAM chips. New 

model now available.$328.00 

UCI RAMSAVER. Maintains power on UCI MEMORY CARD RAM 
when computer is off. Save your programs in RAM with your computer 
off.$168.00 

CDR Z100 SPEED MODULE. Run your Z100 computer at 7.5 MHz. 
Installs easily with no soldering. Externally switchable between Speed 

and Normal mode.$48.00 

Z-216-8 8087 NUMERIC CO-PROCESSOR. Speeds and improves 

numeric processing. Retail $429.00 Payload.$325.00 

WINCHESTER HARD DISK DRIVE EXTERNAL SET-UP. Includes 
Winchester drive, interface card/data separator, power supply/case with 
fan, cables. Computer must have power supply with connector for 

Winchester controller. With 20-MEG (formatted) drive.$1175.00 

WINCHESTER HARD DISK DRIVE INTERNAL SET-UP. Includes all 
items above, less power supply/case. Computer must have power 
supply with connector for Winchester controller. With 20.0-MEG 
(formatted) drive.$985.00 


PAYLOAD COMPUTER SERVICES 

CHARLES C. PORTER, Proprietor 
15718 SYLVAN LAKE 
HOUSTON, TEXAS 77062 
PHONE (713) 486-0687 


Your satisfaction is guaranteed. All hardware carries a 90-day warranty. Prices listed have been discounted for payment with order. VISA and MASTERCARD 
orders accepted. Add $5.00 to all prepaid orders for handling and shipping, we pay the balance. Actual shipping costs billed for net billing orders to approved 
accounts. Texas residents please add 6.125% state sales tax. We accept purchase orders from schools, government and approved accounts. MAIL or PHONE 
your order for prompt service. 
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Z100 Notebook 


William INI. Locke 


GW BASIC 

Z 100 Logo a la Clarkson 
University 

Code corner—painting screen 
regions 

One of a kind 


Correction 

I am sorry to say that I have 
found an error in Listing 1 of the 
“Notebook” in issue #24. The two 
lines that appear as follows: 

IF ERRORLEVEL 1 GOTO error lib 

MYLIB - %1 + %1; 

should appear as follows: 

IF ERRORLEVEL 1 GOTO error 
LIB MYLIB - %1 + %1 ; 

Somehow, LIB moved up to the end 
of the previous line. 


I am told that the Z100, this column’s 
namesake, is no longer being produced 
by Zenith. Oh well, mine will continue to 
be used for years to come. I will continue 
to write about Z100 features and software 
in these pages as long as the interest is 
there. 

I can’t imagine myself writing an IBM- 
clone Notebook. The real purpose of this 
column is to provide holdout Z100 
owners with a source of ideas and infor¬ 
mation relating to their computers. 

GW BASIC 

Four years ago, I built my Heath H89 
and booted it up using the mighty Heath 
Disk Operating System (HDOS). Within 
the day, I was writing programs using 
BASIC, a BASIC known as “Benton Har¬ 
bor BASIC.” Variable names had to be 
single letters; there were few special ma¬ 
chine-related features. And if you made 
an error typing a line, you had to re-enter 
the whole line. 

I did a few short programs with B.H. 
BASIC, but the first program I wrote 
with over 1,000 lines caused my memory 
to go into overload. I was a victim of 
line-number, Ramen Noodle Soup cod¬ 
ing. The program was organized by GOTO, 
patch, and more patch. 

I remember going into the kitchen and 
telling my wife that there had to be 
something better than this. Other than 
BASIC, the least expensive computer 
programming language on the market at 
that time was Toolworks C (C/80), so I 
gave it a try. BASIC was forgotten, and 
I’ve done C since that day. 

When I bought my latest Z100, the 
store owner threw in a copy of GW BA¬ 
SIC. I was not particularly grateful. I will 
admit that I never expected to bother to 
make a copy of the distribution disk. 

The manual got dusty sitting on my 
shelf for months. Well, the other day I 
started looking through it, and I was 
shocked. This is no B.H. BASIC! 

If you’re like me, you might have de¬ 
cided some time back that BASIC was not 
a programming language but rather a tor¬ 
ture device. If so, you might want to take 
another look. The Z100 version of GW 
BASIC is designed to play the Z100 
like a finely tuned piano. The spread 
of graphics and other machine-specific 
features is superb. 

GW BASIC allows the use of standard 
graphics functions to draw lines and 
circles, and paint the screen. It also has a 
rich group of functions for putting figures 
on the screen. These figures are read 
from user-defined strings and placed on 
the screen. A feature even exists to read a 


screen section into a string for future use. 

GW BASIC allows both sequential and 
random file access. With sequential ac¬ 
cess, a file may be opened and informa¬ 
tion may be streamed in or out in the 
same order as it appears in the file. With 
random access, the file may consist of 
records, and it is possible to jump about 
from one record to another. 

GW BASIC has commands for treating 
the Z100 screen as a window into a screen 
of larger graphics coordinates. 

The main problem of BASIC remains. 
An author can easily get wrapped up in 
GOTOs. Apart from this fundamental lan¬ 
guage flaw common to all BASICs, GW 
BASIC is strong. 

Deep in my heart, however, I think 
that BASIC’s syntax is not a good choice 
for learning programming. To my way of 
thinking, a good language encourages the 
development of software tools and the use 
of these tools in larger programs. 

An old debate, I’m sure. I once argued 
for about an hour with a die-hard fan of 
TRS 80 BASIC. I gave up. After all, if the 
computer business is to be a hobby, it is 
up to individuals to enjoy whatever they 
will. The next section deals with an inter¬ 
esting alternative, Logo. 

Z100 Logo a la Clarkson University 

I remember that a few years ago 
Clarkson University started the practice 
of issuing a Z100 to every freshman. I 
do not remember hearing of any other 
school doing this at the time, so that 
action put them in the lead with respect 
to the use of microcomputers. (See “A 
Z100 on Every Desk: Clarkson College,” 
by Frederick Zimmerman, in Sextant #9, 
March-April 1984.) 

The school now has made some power¬ 
ful software packages available for the 
rest of us. VSS-Logo is one of these pack¬ 
ages. (VSS stands for “Virtual Systems 
Software.”) 

The original Logo was invented some 
years ago by Dr. Seymour Papert of MIT 
in an effort to create a language that could 
be taught to small children. (The lan¬ 
guage is derived from the Lisp language 
but lacks Lisp’s complexity. The original 
name of Logo was “Simple Lisp.”) 

I suspect that if Logo had come on the 
scene before BASIC, it might well have 
become as widely used as BASIC is now. 
Today, one of its strong points is that it’s a 
Lisp-like artificial-intelligence language 
that’s easier to learn than Lisp. Some¬ 
thing that probably attracts a lot of 
people, however, is Logo’s capability in 
handling graphics. 

With early versions of Logo a me- 
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chanical device, known as a turtle, was 
controlled by a computer and would rove 
about on a piece of paper, marking it with 
a pen. The computer running Logo could 
be easily instructed to draw all sorts of 
figures to the delight of visiting children. 
Kids were taught to program. 

The advent of the graphics terminal, 
such as that of the Z100, has made the 
mechanical turtle unnecessary. Logo is 
now able to control a turtle on the com¬ 
puter screen; it can draw using the same 
commands that were used years ago with 
the original setup. 

VSS-Logo comes to you in the form of 
an interpreter; the language package it¬ 
self is the environment with which both 
you and your program interact. The lan¬ 
guage package has to.be run in order to 
run your program. This is the same idea 
as in BASIC and several other language 
programs. 

The actual control of the turtle is ex¬ 
tremely simple. If you type FORWARD 100, 
for example, the turtle moves forward 
100 units; if you type RIGHT 90, it turns 
right 90 degrees. The turtle can be 
directed to lift up the pen and stop mark¬ 
ing the screen in order to be moved to 
another location on the screen to start 
drawing again. 

Clarkson has included many com¬ 
mands that allow the user to use the 
special features of the Z100. These 
commands allow things such as: splitting 
the screen between the graphics region 
and the text region; changing the color of 
the turtle’s pen; painting in a closed 
region that has been drawn by the turtle; 
and quickly putting predefined figures, 
“sprites,” on the screen. You can define 
several graphics windows on the screen 
and use them for separate graphics 
figures. Screen pictures may be saved on 
a disk and later recalled. All in all, the 
command set is rich, but it does not mask 
the simple turtle action. 

Here is a sample of a Logo session; 
typing in the commands below will clear 
the screen and draw a box on the screen: 
CLEARSCREEN 
FORWARD 100 RIGHT 90 
FORWARD 100 RIGHT 90 
FORWARD 100 RIGHT 90 
FORWARD 100 RIGHT 90 

Logo control structures exist to make 
generation of complicated figures easier. 
These take the language a step up in 
abstraction from the stage of manually 
driving the turtle. As an example, you 
may write: 

CLEARSCREEN 

REPEAT 4 [ FORWARD 100 RIGHT 90 ] 

This clears the screen and repeats the 
list [ FORWARD 100 RIGHT 90 ] four times. 

Logo can go one step further by allow¬ 
ing the user to define a procedure to draw 
a figure. Typing the name will then draw 
the figure. Here is an example: 

TO BOX 

REPEAT 4 [ FORWARD 100 RIGHT 90 ] 

END 

Now typing the word BOX would draw 


the box. 

Logo procedures may be as compli¬ 
cated as the user desires. They may take 
parameters; they may use local variables; 
and they may call other user-defined 
procedures. It is even possible for a 
procedure to make a recursive call on 
itself. 

The features that I have described thus 
far can be combined to make all sorts of 
interesting figures, including complicat¬ 
ed fractal geometry figures. A random- 
number function is included. 

In spite of its origin, Logo is no toy 
language. It actually has nearly all the 
features of Lisp. It has been used to 
create games—such as Hangman and 
Animal—and other typical artificial-intel¬ 
ligence programs. It includes a rich set of 
math functions including sine, cosine, 
tangent, exponentials, and logarithms. 

There is some variation in the different 
versions of Logo. The command syntax is 
a bit different in the MIT and Apple 
versions of the language, for instance. 
VSS-Logo most closely follows the ver¬ 
sion of the language offered for the IBM 
Personal Computer, but it has some signi¬ 
ficant improvements over that version. 

Plainly put, there is no consistent Logo 
standard as yet. 

It is safe to say that VSS-Logo is one of 
the strongest versions of the language 
available. Two of the features that place 
this version above others are a powerful 
built-in full-screen editor and the ability 
to mix command text and graphics on the 
screen. 

There are still a few rough spots in 
VSS-Logo. One shows up when a pro¬ 
gram is being read into the Logo envi¬ 
ronment; if the disk file is not terminated 
with a control-Z, the Logo interpreter 
will fail to read the file correctly. Another 
problem (having to do with the multipli¬ 
cation of numbers) that I noted was fixed 
within a week of my reporting the 
problem to Clarkson. Impressive turn¬ 
around time for bug fixes! 

The VSS-Logo documentation is a for¬ 
mal language definition. It is clearly writ¬ 
ten, but it does not teach the language. 
Clarkson is developing an additional tu¬ 
torial, and you might want to contact 
them about it. I have seen a preliminary 
version of this tutorial, and it allowed me 
to quickly learn the graphics aspects of 
the language. 

I discovered a Logo special interest 
group among the Software Forums sec¬ 
tion of CompuServe. This SIG included 
several example Logo programs in the 
Data Libraries (DLs). There was also a 
host of papers in DL9 of the SIG on the 
subject of Logo in the classroom. The 
availability of a version of Logo for the 
Apple seems to have created a Logo sect 
in the community of teachers across the 
land. 

Accompanying this column are the 
names of some Logo user groups available 
to help those of us that are new to the 
language. I found the list in one of the 


Six Logo User Groups 

Friends of Lisp/Logo & Kids 
(FOLLK) 

436 Arballo Drive 
San Francisco, CA 94132 

Friends of the Turtle 
P.O. Box 1317 
Los Altos, CA 94022 

Logo Information for Teachers 
(LIFT) 

P.O. Box 5396 
Plymouth, MI 48170 

Microquests 
Martin-Bearden, Inc. 

P.O. Box 337 
Grapevine, TX 76051 

Polyspiral 

Boston Computer Society 
Three Center Plaza 
Boston, MA 02108 

Technical Education Research 
Centers 

1696 Massachusetts Avenue 
Cambridge, MA 02138 


Logo SIG Data Libraries. (I recently 
wrote to several of the addresses asking 
for information, but I have not yet 
received answers.) 

In conclusion, VSS-Logo is a treat 
specifically for Z100 users. As far as I 
know, it is not available for the IBM-PC 
clones. This is one of the most interesting 
Z100-specific items that I have seen. 

Code corner—painting screen 
regions 

One of the most interesting problems 
that I have taken on with a computer is 
painting an arbitrary region with color. 
(Some computer languages call this activ¬ 
ity “filling” the screen; I have chosen to 
call it “painting”) This issue’s “Z100 
Notebook” code corner is a presentation 
of how this problem can be solved. 

Painting is a graphics problem that in¬ 
volves filling an area of the screen with 
color. For regular shapes, this can be 
done using simple routines. But if an 
arbitrary shape is to be filled, the 
algorithm involved is more interesting. 
Two painting algorithms will be presen¬ 
ted here, one simple but limited, and one 
more complex but also more useful. 

For the purposes of this article, I will 
define painting as the filling of an arbi¬ 
trary bounded area with a color. Painting 
will stop at any pixel that the routine 
detects as “on”; so, the boundary may be 
of any color. As an example, the area 
within a green circular boundary may be 
painted with red. This definition is more 
limited than that in several BASICs, 
where one can specify both a color to be 
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painted and a color to act as the boundary. 

Listing 1 shows paint( ), the simpler 
version of the paint algorithm (written in 
DeSmet C). In the version of the paint 
algorithm shown in Listing 2, the screen 
edge is treated as a boundary. This paint 
function should be able to paint the entire 
screen as if it were surrounded by a box. 
Listing 1 omits this feature to keep the 
code simple. 

Two functions 

Both painting functions will use two 
low-level functions that are ZlOO-specific. 
These are point( ) and readbd(). (A 
simple C version is provided for both in 
Listing 2.) Rewriting these functions in 
assembler would speed up the painting 
considerably. The versions given here are 
simplified to ease understanding at the 
expense of speed. 

The point( ) and readbd( ) functions 
are described as follows: 
point(x,y,color) 

This function is used to turn on one of 
the three points (green, red, or blue) that 
make up a given screen “dot” or picture 
element (pixel). The point( ) function 
normally returns a one unless the point 
coordinates specified would be off the 
screen. In that case, point( ) returns a 
zero. The allowed color specifications are 
R, G, and B. The allowed ranges for x and 
y are: x = 0 through 639; and y = 0 
through 215. The point (0,0) is the upper 
left-hand corner of the screen, 
readbd (x,y) 

readbd( ) stands for “read boundary.” 
This function is used to check whether a 
pixel at (x,y) is turned on in any color. If 
the pixel is on, this function will return a 
one. Otherwise, it will return a zero. 
Recursive painting, 

Simple recursion is the use of a func¬ 
tion which calls itself as part of its opera¬ 
tion. This often consists of the function 
looking at its input argument and choos¬ 
ing either to return a value, or to do some 
math and then call itself with a new value 
of the input argument. 

In C, a recursive routine requires a 
considerable amount of stack space for 
temporary storage. This is because the 
program keeps track of the variables at 
each level by leaving them on the C- 
language stack in anticipation of the fu¬ 
ture return to that level. 

Recursion may be used to produce an 
easy solution to the painting problem us¬ 
ing the following steps. 

1. When paint( ) is called at the posi¬ 
tion (x,y), first it calls point( ) to mark 

(x,y). 

2. It then looks to the right one place to 
see if that pixel is turned on; if it’s not, 
paint( ) calls itself at that position. 

3. It looks to the left one place to see if 
that pixel is turned on; if it’s not, paint() 
calls itself at that position. 

4. It looks up one place to see if that 
pixel is turned on; if it’s not, paint( ) calls 
itself at that position. 

5. It looks down one place to see if that 


paint(x,y,color) 
int x,y; 
char color;{ 

point(x,y,color); /* Turn on the pixel at x,y */ 
if(Ireadbd(x+1,y))paint(x+1,y,color); /* Look right */ 
if(!readbd(x-1,y))paint(x-1,y,color); /• Look left */ 
if(Ireadbd(x,y+1))paint(x,y+1,color); /» Look down */ 
if(Ireadbd(x,y-1))paint(x,y-1,color); /* Look up */ 
} 


Listing 1. The recursive version of paint() is very simply coded, but uses a lot of stack 
space when it is run. 


Listing 2. The non-recursive version of paint() uses a programmer-defined stack. The code 
is much longer than that of the recursive version (Listing 1), but this version uses up much 
less storage space when it is run. 


main(){ /* Example - Fill in a region enclosed between two boxes «/ 

int x,y; 

_outb( 0x78,0xD8);/* Enable graphics */ 

puts( w \033E"); /« Clear screen and turn off cursor */ 

for (x=40;x<=320;x++) for (y=10;y<=150;y+=l40) point( x,y,'G’); 
for (y=10;y<=150;y++) for (x=40;x<=320;x+=280) point( x,y,'G'); 
for (x=120;x<=220;x++)for (y=50;y<=100;y +=50) point( x,y,'G'); 
for (y=50;y<=100;y++) for (x=120;x<=220;x+=100) point( x,y,’G’); 
paint(200,125, 'G'); /• Paint in the enclosed region */ 

} 

/» 


Paint(x,y,color) 

x,y are coordinates of starting point. Color is the color plane to be 
used for painting. The painting fills to any color boundary. 

«/ 

^define STACK_SIZE 10 /* The number of K reserved for the paint stack */ 

#define MARK_STACK_END -10 /* Paint stack end marker */ 

^define COLOR 0 /* Set equal to 1 for color; 0 for black and white */ 

/* Stack structure */ 

static struct { int x_val; int y_val;} «stk_ptr ,*stk_base; 


/• Stack pushing routine */ 
static push_paint(x,y){ 

stk_ptr->x__val = x; /* Store the x value in structure */ 
stk_ptr->y_val = y; /* Store the y value in structure */ 
++stk_ptr; /* Move to the next stack structure */ 
} 


/• Stack popping routine - Returns 0 if MARK_STACK_END is found */ 

static pop_paint(x_J>tr,y_ptr) /* Note that the values are placed in */ 

int *x_ptr, f y_ptr;{ /* positions pointed to by x_ptr and y_ptr */ 

—stk__ptr; 

*x_ptr = stk_jptr->x_val; /• Place the x value at x_j>tr*/ 
f y_ptr = stk_ptr->y_val; /* Place the y value at y_ptr # / 
if( *x_ptr == MARK_STACK_END ) return 0; 
else return 1; 

} 


paint(x,y,color){ 

int rgt_flg, Ift_flg; 
char *malloc(); 

/* Allocate a stack of size STACK_SIZE K. and assign stack pointers */ 
stk_base=stk_ptr=(struct stk *)malloc(STACK_SIZE * 1024); 

/• Mark the bottom of the stack with -10,-10 • / 
push_paint (MARK_STACK_END , MARK_STACK_END); 

push_paint( x,y); /• Put the starting position on the stack */ 

/• Start the actual painting */ 

while( pop_paint(&x,&y) ){ /* Pop off the starting point •/ 

lft_flg=rgt_flg =1; /* Start with stack push switches = 1 •/ 

/* Move to the top of the screen or a boundary, whichever is first */ 
while( y >= 0 ){ if(readbd(x,y) )break; y—; } 

++y; /* Move back down by one unit •/ 

/• Perform while the point (x,y) is not on a boundary */ 
while( !readbd(x,y) ){ 

if(!point(x,y,color)) break; /• Screen edge - do next pop */ 

/• Look right and push if a hole is found •/ 

if( readbd(x+1,y) ) rgt_flg =1; /• Pixel on, Reset the switch »/ 

else if(rgt_flg){ /* Pixel off => push position */ 

rgt_flg =0; /* Push next only when needed */ 

push_j?aint( x+1,y); 

} 
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/• Look left and push if a hole is found */ 

if( readbd(x-1,y) ) lft_flg =1;/* Pixel on, Reset the switch •/ 

else if(lft_flg){ /« Pixel off => push position */ 

lft_flg = 0; /• Push next only when needed */ 

push_paint( x-1,y); 

} 

y++; /• Go down to the next scan line */ 

} 

} 

free(stk_base); /• Free the paint stack space •/ 
return 1; 

} 

/• This Z100 code supports the paint routine. It would be faster in ASM */ 
char _peek(); 

unsigned scan,row,column,bit,off,byte.segment; 

point(xi,yi,color){ /• x <= (0, 639); y <= (0» 215); color <= (R,G,B)*/ 
if( xi < 0 !I xi > 639 ii yi < 0 II yi > 215) return 0; /• Error «/ 

if ( ICOLOR || color== f G f II color==’g*)segment = 0xE000; /• Green */ 
else segment = ( color=='R'I|color=='r 1 )? 0xD000:0xC000;/* Red:Blue */ 
columns xi/8; bit=0x80»xi$8; row=yi/9; scan = yi$9; 
off=row«11 |scan«7 {column; 

_poke( _j?eek(off.segment)|bit .off.segment); 
return 1; 

} 

readbd(xi,yi){/*Return 1 if pixel is on in any color. Otherwise return 0.*/ 
columns xi/8; bits0x80»xi$8; rowsyi/9; scan s yi$9, 
offsrow«11 |scan«7 Icolumn; 

#if COLOR 

if((_peek(off,0xE000)|_peek(off,0xD000)|_peek(off,0xC000))&bit)return 1; 
#else 

if((_peek(off,0xE000)&bit))return 1; 

#endif 

else return 0; 

} 


pixel is turned on; if it’s not, paint( ) calls 
itself at that position. 

When paint( ) is finished, the whole 
bounded area will be painted. 

In the interest of keeping things 
simple, I have made no effort to cause this 
algorithm to be well behaved when the 
area is not enclosed by a complete bound¬ 
ary. If your region has a hole in its bound¬ 
ary, you will need to exercise the reset 
button. 

This entire function, in C, is demon¬ 
strated in Listing 1. 

This simple form of paint( ) works on 
small regions; but if the region is large, it 
will cause a crash. The reason for this 
flaw is that, with recursion, the payback 
for simplicity of programming is stack 
growth. Every time the paint( ) function 
calls itself, the values of x, y, color, and 
the function return address are being 
pushed onto the stack. This amounts to 
eight bytes being added to the stack with 
each function call. The computer will 
quickly run out of stack space (unless it is 
one of those theoretical computers that 
has infinite storage space). 

Painting with a home-made stack 

The best way to overcome the problem 
of the runaway stack is to redo the 
paint( ) function without recursion and 
to save (x,y) positions only when really 
needed. These changes will complicate 
the painting algorithm, but the result will 
be a working routine that will not fail on 
large areas. This version will also function 
properly at the screen boundaries. 

First, we should build our own stack 
system. 


This stack will be carved out of an 
allocated memory region to hold a series 
of (x,y) pairs. Each level of the stack 
will consist of two integers: x-val, and 
y-val. Since an integer value in C 
requires two bytes, the stack will be a 
sequence of four-byte structures. The 
function push_paint( ) will be used to 
place (x,y) values onto this stack, and 
pop_paint( ) will be used to retrieve 
them. 

The bottom of the stack is marked with 
a special marker by setting both the x and 
y stack values equal to -10 with an initial 
push_paint( ). The pop_paint( ) func¬ 
tion will return a zero if this bottom 
marker is found. This feature is used to 
terminate painting. 

The general plan is to start at the top 
of the bounded area and proceed down¬ 
ward, marking with point( ), and looking 
for places where the pixel to the right or 
left of the one just marked goes from on to 
off. These points will be corners in the 
paint and will be the starting points for 
painting on subsequent passes. These 
corner locations will be saved on the paint 
stack. 

The algorithm is as follows: 

I. Allocate memory for the paint stack. 

II. Mark the bottom of this stack with 

(- 10 ,- 10 ). 

III. Push the starting (x,y) values onto the 
stack. 

IV. Pop the stack. While the value 
popped from the stack is not the bottom 
marker (-10,-10), perform the following: 

1. Move to the top of the bounded 
region by reducing y until a boundary is 


found. Then move back down one to the 
first unmarked pixel. (Remember that y 
increases as you go down.) 

2. While the pixel at the (x,y) position 
is off ‘ do the following: 

a. Turn on the pixel at the (x,y) position 
using the desired color. 

b. Look at the pixel to the right of the one 
just marked and see if it is off. If it is, and 
the last right pixel checked was on, a 
corner has been found. Push this (x,y) 
position onto the paint stack. 

c. Look at the pixel to the left of the one 
just marked and see if it is off. If it is off 
and the last left pixel checked was on, a 
corner has been found. Push this (x,y) 
position onto the paint stack. 

d. Move down to the next y position. 
Remember that y is zero at the top of the 
screen. 

e. Continue looping through the WHILE 
command of step 2. 

3. Continue looping through the 
WHILE command of step IV. 

V. Free the space saved for the painting 
stack and return. 

Listing 2 implements this algorithm. It 
also gives a simple example routine and a 
version of readbd( ) and point( ) that 
will get you started on the Z100. The 
allowed range of x is 0 through 639, and 
the allowed range of y is 0 through 215. 
The only colors allowed for this version of 
point( ) are red, green, and blue 
(R, G, B). 

As noted above, the compiler used 
with this code is DeSmet C. To change 
the code for use with other compilers, 
simply modify the port-output function, 
_outb( ), and the _peek( ) and _poke() 
functions. All the code in the paint() 
function itself should be usable regardless 
of the compiler. 

Once again, for your convenience, I 
have uploaded Listings 1 and 2 onto DL9 
in the Heath Users’ Group bulletin board 
on CompuServe. 

One of a kind 

From time to time, a man gains such a 
stature that some are led to assume that 
he will always be around. 

Such a man was Admiral Hyman G. 
Rickover. He was certainly feared more 
than befriended. A man of enormous 
power whose contribution to our land is 
beyond measure. 

Admiral H. G. Rickover, dead, age 86, 
July 8,1986. 

Ordering Information 

GW BASIC (for the H/Z100), $100. 
Heath Company 
Benton Harbor, MI 49022 
800/253-0570 

VSS-Logo, $49. 

Clarkson University 
Educational Computing Dept. 

Potsdam, NY 13676 

315/268-6455 A 
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An MBASIC Simulation 

Examination of the regulation of blood pressure inside the kidney demonstrates 
a general approach to computer simulation. 


Robert W. Rasch 


Name the States, Numbers Drill, and 
other aids to memorization probably have 
their place in primary-school education. 
However, the current popularity of ar¬ 
cade games indicates a considerable po¬ 
tential for computer simulations of events 
and processes. Simulations can be used to 
train jet pilots and astronauts—why not 
doctors and scientists? 

Engineers have used simulations to 
stimulate their thinking for many years. 
In the past, however, they have had to 
expend considerable sums of money 
while developing a single simulation on a 
mainframe computer. Now, models can 
be developed on microprocessors and can 
be accomplished with graphic embellish¬ 
ments that resemble those of the video 
arcade. 

Learning by doing has always been 
more effective for me than passive listen¬ 
ing. It would be difficult for anyone to 
learn how to drive an automobile by 
listening to a lecture. Learning by active 
participation requires the exercise of 
what has been learned, and that is easier 
than rote memorization. An experienced 
teacher knows that the instructor usually 
learns more from a lecture than the 
students do—because of the active role of 
the lecturer. 

Scientists develop simulations of real 
phenomena to test their theories of how 
the phenomena work. Sometimes the 
simulation indicates that the theory is not 
a good one; sometimes it leads to im¬ 
provements in the model that are 
enhancements of the theory. 

“Aha! Now I understand!” is a frequent 
reaction to the exercise of a simulation. 
So, let's write a simulation and watch how 
it works to stimulate our thinking and 
imagination. Here, we will use a problem 
in physiology. 

This simulation, with some thought on 
your part, may explain to you a bit about 
how your kidneys work. (And you thought 
you'd just learn about computers in these 
pages!) 


Robert W. Rasch chairs the Physiology 
Department at the Quiller-Dishner 
College of Medicine at Eastern 
Tennessee State University. 


Perhaps, also, working with an exam¬ 
ple like this may encourage you to try to 
develop a simulation of your own— 
whether in biology or automotive engi¬ 
neering. Toward that end, we’ll see if we 
can draw some generalizations that may 
be helpful to other simulations. 

A look at the filtration process 

It is difficult to explain physiologic phe¬ 
nomena to others when many variables 
are changing at the same time. The 
problem is that the learner does not know 

Flow of blood behaves 
much like a flow 
of current in an 
electric circuit. 

what to watch next and misses the essen¬ 
tial action. 

The regulation of the filtration pressure 
of the human kidney is an example of that 
kind of mechanism. 

To give you a quick refresher, the kid¬ 
neys clean out impurities—mainly water 
and waste products—from the blood. The 
kidneys sit beside one of the body’s main 
arteries, the abdominal aorta; the arteries 
supplying blood to the kidneys—the re¬ 
nal arteries—branch off from the abdomi¬ 
nal aorta, and each kidney receives about 
14% of the blood. (See Figure 1.) 

After it’s filtered, the blood goes back 
to the heart and lungs to resume its circuit 
through the body. Acting on the happy 
assumption that the 28% of the blood sent 
to the kidneys is a valid statistical sample, 
we can conclude that the blood should be 
kept suitably filtered. 

Inside the kidney, the filtration of 
blood is known to occur in the glomeruli 
of the kidney. After these cell structures 
filter the blood, it is returned to the lungs 
and heart. The remainder, water and 
waste products, is excreted as urine. 

The energy for filtration comes from 
arterial blood pressure. (Blood pressure is 
measured in millimeters of mercury— 
mmHg. The resulting blood flow is 


measured in milliliters per minute.) 

Blood pressure fluctuates, so we might 
assume that filtration and blood flow 
would do likewise. Within a certain range 
of pressures, however, filtration and 
blood flow remain constant. That phe¬ 
nomenon is what we ll look at here. 

At rather low blood pressure (below 90 
mmHg) and at rather high blood pressure 
(above 200 mmHg), the filtration rate and 
blood flow through the kidney will 
change with any change in blood pres¬ 
sure. The greater the pressure, the more 
blood is filtered. 

But in the middle range, fluctuation of 
blood pressure has no effect on flow and 
filtration. 

The net effect is that both the glomeru¬ 
lar filtration rate and the renal blood flow 
remain remarkably constant at blood 
pressures between 90 and 200 mmHg. 
This has been called autoregulation. 

The process of regulating pressure 
within the kidney is thought to consist of a 
regulation of blood flow through it. That, 
in turn, is controlled by the constriction 
or relaxation of certain of the smallest 
arteries in the kidney that lead to the 
glomeruli (the afferent arterioles) and 
from the glomeruli (the efferent arteri¬ 
oles). The total renal resistance to blood 
flow is contributed almost entirely by the 
action of the afferent and efferent 
arterioles. 

(We might expect the action of the 
arterioles to be regulated by something 
being delivered to the kidney in the blood 
flow: a hormone, say. Or it could be regu¬ 
lated by reactions to an elevated pressure 
alone. Both explanations have been sug¬ 
gested in the physiologic literature. Let’s 
not commit ourselves to either view.) 

See Figure 2 for a graph of the relation¬ 
ship between renal blood flow, filtration 
rate, and blood pressure. 

Building a model 

To better understand the processes, we 
can use an electrical analogue for the 
physical situation as we begin to model it. 

And to start the organization of our 
thoughts, let’s first look at glomerular 
filtration pressure. As we step through 
this process, refer to Table 1 for a quick 
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reference to the mnemonics we’ll be 
using. 

Each kidney is supplied with blood by 
only one artery, its renal artery. The blood 
pressure there gives rise to a blood flow 
through the kidney, and is the source of 
energy for the filtration process. No 
glomerular filtration can occur without 
glomerular pressure. Also, the amount of 
filtration will be directly proportional to 
the pressure in the glomeruli. 

Flow of blood behaves much like a flow 
of current in an electric circuit. As such, it 
can be described by a re-wording of 
Ohm’s Law. Ohm’s Law says that current 
(I) through a circuit is directly propor¬ 
tional to voltage (E) and inversely propor¬ 
tional to resistance (R). As a formula: 

I = E/R 

We can “translate’’ that as: 

FLOW = RBP/TRES 



receives from the abdominal aorta (via the 
renal artery). Filtered blood is returned to 
general circulation, waste products to the 
bladder. The rate at which blood is filtered 
is graphed in Figure 2. 



Figure 2. Through a wide range of blood 
pressures, the blood flow through the 
kidney and the rate at which blood is 
filtered remain quite constant. This process 
of autoregulation is demonstrated by the 
program given in Listing 2. 


Here, RBP is the renal blood pressure, 
and TRES is the total resistance to blood 
flow through the kidney. TRES consists 
of two components: afferent resistance 
(affres), which resists flow into the kid¬ 
ney; and efferent resistance (effres), 
which resists flow out of the kidney. 

Based on this electrical analogue, a first 
model of the process is shown in Figure 3. 

Knowing the blood flow and the renal 
blood pressure, we can also find out how 
much pressure will be available to the 
glomeruli. This is the glomerular filtra¬ 
tion pressure (gfp). To find this, we have 
to know the effect of the afferent resistor 
(AFFRES). As blood flows through the kid¬ 
ney, AFFRES will cause a drop in pressure. 
Going back to Ohm’s Law will tell us 
how much pressure we will lose across 
AFFRES: 

DROP = AFFRES X FLOW 



R1 = AFFRES 
R2 = EFFRES 
G = THE GLOMERULI 
I = BLOOD FLOW 

El = E = GENERAL BLOOD PRESSURE 
E2 = GLOMERULAR FILTRATION PRESSURE 


Figure 3. The flow of blood into and 
out of the kidney can be modelled 
electrically by Ohm’s Law: current = 
voltage/resistance (I = E/R). The 
equivalences listed here help express this 
principle in terms of the kidney. 


Therefore, the GFP will be RBP — DROP. 

The effect of the kidney’s autoregula- 
tory behavior is graphed in Figure 2. 
There, RBP and average arterial blood 
pressure are assumed to be the same. 
(They’re close enough for that to be 
acceptable.) 

As noted above, both the glomerular 
filtration rate and the renal blood flow are 
held constant over a range of arterial 
pressures (despite the fact that we might 
expect both the filtration rate and the 
blood flow itself to increase with increases 
in pressure). 

Evidently, over a span of blood 
pressures, there are changes in the resis¬ 
tance to blood flow that account for auto¬ 
regulation of blood flow and glomerular 
filtration rate. (That is handy. We would 
not want urine formation to be a direct 
function of blood pressure. That could be 
inconvenient and certainly unphysiolog- 
ic: running might prove very distressing.) 

TRES, then, must change to effect an 
autoregulation of renal blood flow: as 
pressure goes up, TRES must increase. 
But we re concerned with more than 
blood flow; the GFP must also remain 
constant. The resistances— AFFRES and 
EFFRES —change to bring this about; in 
order to keep GFP constant under increas¬ 
ing RBP, AFFRES must increase and 
EFFRES must decrease. 

In the intermediate range of RBP, this 
keeps both blood flow and GFP rather 
constant. At low and high RBP, the 
kidney’s power to adapt—its “physiologic 
reserve’’—is exceeded, and the flows are 
a linear function of pressure. 

The failure at low pressure is easy to 
understand: if the arterial pressure is low¬ 
er than the required filtration pressure, 
then we cannot achieve that filtration 
pressure. The simulation should provide 
an answer to why regulation fails at high 
pressures. 

First, we should note that there is a 
limit to how high AFFRES can be when RBP 
is elevated. This is because as AFFRES 
rises, although the GFP can be main¬ 
tained, there will be a diminution of flow 
in the region of the kidney beyond 


Mnemonic 

Description 

AFFRES 

Afferent resistance to blood flow through the kidney 

DROP 

Amount of pressure lost across AFFRES 

EFFRES 

Efferent resistance to blood flow through the kidney 

FLOW 

Flow of blood through the kidney 

GFP 

Glomerular filtration pressure 

MAXAFF 

Maximum afferent resistance 

MINEFF 

Minimum efferent resistance 

RBP 

Renal blood pressure 

TRES 

Total resistance to blood flow through the kidney 


Table 1. Mnemonics used in the kidney simulation. 
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EFFRES. That is a situation that cannot be 
tolerated by the cells of the kidney. Maxi¬ 
mum afferent resistance (MAXAFF), then, 
is one limiting factor. 

Similarly, TRES cannot be lowered to 
zero; it has a minimum value because of 
the physical environment in the kidney. It 
appears that a kidney s afferent resistance 
can go quite low. The limitation appears 
to come in resistance to the flow of blood 
out of the kidney. The minimum efferent 


resistance (mineff), then, is our other 
limiting factor. 

Writing the program 
There! We have described our simula¬ 
tion in words. It may not seem so, but all 
the factors are there. The important for¬ 
mulae have also been established; we 
need only to translate what we said into a 
computer language before putting our 
simulation into operation. 


Basically, we need a program that lets 
the user change one or more of the signif¬ 
icant variables and see what effect that 
has on the process. 

We could settle for a simple math 
program giving us a list of figures. But it 
would be nice to have the output dis¬ 
played in some sort of picture format. As 
you’ll see, attractive formatting of the 
output is the only time-consuming part of 
the whole operation. 

A summary of what we have covered is 
given in Listing 1. It is a skeletal outline 
of the simulation. 

In Listing 1, the outline has been writ¬ 
ten in a sort of “pseudo-code”; it can be 
translated into any computer language. In 
this form, it would be easy to translate it 
into C, because C lacks line numbers. Of 
course, the same program could be trans¬ 
lated into FORTRAN or BASIC. 

As you can see, I kept it pretty close to 
BASIC. Let’s do it in BASIC, because 
more users know this language than any 
other. And there is no need for fast com¬ 
putation in this model. 

(In some simulations, simple formulae 
cannot describe the process. Program 
loops have to be set up to arrive at itera¬ 
tive solutions; thereby we solve a prob¬ 
lem with progressive small changes in 
values that move us closer to the answer. 
In such cases, greater speed is needed 
because of the many loops involved.) 

Were you to write your own simulation 
for some process, I’d suggest you start it 
with something like the outline in Listing 
1. With a text editor, enter it into a file 
with a .BAS file extension—let’s call it 
TEMPGFP.BAS. You can then add line 
numbers with the CP/M command: 

PIP GFP. BAS=TEMPGFP. BAS[NZ] 

The [N] option will add the line numbers 
to GFP. BAS. In the event your editor may 
have set the high (eighth) bit of any 
characters (as does WordStar) or thrown 
in any other unusual characters, the [Z] 
option strips the high bits to leave you 
with the ordinary ASCII characters that 
BASIC expects to see. 

Now the translation can begin. My fin¬ 
ished version is in Listing 2. 

Putting in graphics from 
Ed-A-Sketch . . . 

In Listing 2, note that cursor controls 
are installed to place values into the pic¬ 
ture that the program will call. Figure 4 
shows an output listing from a run of a 
“stripped-down” version of Listing 2, one 
without the cursor controls, but with 
titles added to the display routine. (User 
input is underlined.) You can see that the 
program works, but the output is a bore. 

To provide a little more interest and 
make it easier to pick out the variables of 
interest, we should somehow create a 
picture of the action. Using cursor con¬ 
trols and reverse video to outline the 
significant features, we can then place the 
values of the various variables into appro¬ 
priate positions. As given in Listing 2, the 


Current working values 


START PROGRAM. Draw a glomerulus with labels. 

GOSUB PICTURE 
ENTER default values: 

Enter <0.2> MAXAFF < 

Enter <.06> MINEFF 
Enter <.28> MAXTRES 
Enter <650> FLOW 
Enter <50> GFP < 

LOOP enter RBP or reset to change the above values 
IF LEN(AN$)=0 THEN GOTO ENTER 
IF RBP<=GFP THEN : 

PRINT"Physiological Reserve Exceeded": 
REVERSE VIDEO AND TELL USER: 

RING BELL TO TELL USER 
GFP=RBP 

IF RBP<=0 THEN PRINT"No Pressure for Flow":PAUSE: 
RING BELL: 

REVERSE VIDEO: 

GOSUB PICTURE to erase invalid entries: 

GOTO LOOP 
GOSUB CALCULATE 

GOSUB CHECK MAX AND MIN RESISTANCES 
IF SW>0 THEN GOSUB RECALC 
GOSUB DISPLAY 
GOTO LOOP 

ROUTINES BELOW MAIN PROGRAM ABOVE 

CALC calculate the values and then return 
TRES=RBP/FLOW: 

DROP=RBP-GFP: 

AFFRES=DROP/FLOW: 

EFFRES=TRES-AFFRES: 

RETURN 

CHECK see if maximum or minimum resistances have been 
exceeded - fix them as required. 

SWr0»set RECALC switch off - no changes made 
IF AFFRES>MAXAFF: 

THEN AFFRES=MAXAFF: 

SW=SW+1’make change and note 
that it has happened by setting switch (SW) 
IF EFFRES<MINEFF: 

THEN EFFRES=MINEFF: 

SW=SW+1 

IF TRES>MAXTRES THEN: 

TRES=MAXTRES: 

SW=SW+1 

RETURN 

RECALC switch was set - one of the resistances was out of 
bounds 

SW=0’first trip switch then recalculate resistances 

TRES=EFFRES+AFFRES’check and see if too big 

IF TRES>MAXTRES THEN TRES=MAXTRES’it was so fix it 

IF DROP<0 THEN DROP=0'negative values no good here 

FLOW=RBP/TRES'now redo the flow 

AFFRES=DROP/FLOW'in case it is inconsistent 

IF AFFRESMAXAFF THEN AFFRES=MAXAFF 

EFFRES=TRES-AFFRES 

GFP=RBP-AFFRES*FLOW 

IF DROP=0 THEN GFP=RBP 

RETURN 

PICTURE this routine should draw a picture on the screen 
with appropriate labels 
RETURN 


Listing 1. A skeletal outline of the kidney simulation. The simulation is given in full form 
in Listing 2. 
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Listing 2. GFP.BAS—written for Microsoft BASIC under CP/M—simulates the operation of 
the kidney’s blood-filtering activities. 


10 ’Program GFP.BAS 

20 DEF FNC$(R,C)=CHR$(27)+"Y"+CHR$(R+31)+CHR$(C+31) 'define 
cursor control row(R) and column(C) 

30 'Robert W. Rasch version (8.12.84) 

40 'Box 19.870A 

50 'Quillen Dishner College of Medicine 
60 'Johnson City, TN 37614 
70 '(615) 928 6426 x235 

80 PRINT CHR$(27)"EThis program will simulate the activity of auto 
regulation in the kidney." 

90 PRINT"It shows how the afferent and efferent resistances leading 
to the glomerulus " 

100 PRINT"are altered to maintain the renal blood flow and glomerular 

filtration »CHR$(27)"p":PRINT"PRESSURE";CHR$(27)"q at rather constant 
levels." 

110 PRINT:PRINT:PRINT"Remember it is the pressure that is being regulated 
in this model" 

120 PRINT"not the glomerular filtration rate. The regulation of the 
filtration" 

130 PRINT"rate would require some additional considerations." 

140 PRINT:PRINT 

150 PRINT"DEPRESS ANY KEY TO CONTINUE"; 

160 A$=INPUT$(1) 

170 GOSUB 800'DRAW THE PICTURE 
180 PRINT FNC$(20,1);CHR$(27)"K"; 

190 PRINT"A RETURN WILL ENTER DEFAULT VALUES UNTIL YOU REACH RBP " 

200 PRINT FNC$(21,1);CHR$(27)"K"; 

210 PRINT"Type END to EXIT this program"; 

220 PRINT FNC$(22,1);CHR$(27)"K"; 

230 INPUT"Enter Maximum Value of Afferent Resistance <.2> ",AN$ 

240 IF LEN(AN$)<>0 THEN MAXAFF=VAL(AN $) ELSE MAXAFF=.2 

250 IF LEFT$(AN$,1)="E" OR LEFT$(AN$,1)="e" THEN WIDTH 80:END 

260 PRINT MAXAFF:PRINT FNC$(21,1);CHR$(27)"K"; 

270 PRINT FNC$(22,1);CHR$(27) n K"; 

280 INPUT"Enter Minimum Value of Efferent Resistance <.08> ",AN$ 

290 IF LEN(AN$)<>0 THEN MINEFF=VAL(AN$) ELSE MINEFF=.08 
300 PRINT MINEFF 

310 PRINT FNC$(22,1);CHR$(27)"K"; 

320 INPUT"Enter Maximum Value of Total Renal Resistance 
to Blood Flow <.28> ",AN$ 

330 IF LEN(AN$)<>0 THEN MAXTRES=VAL(AN$) ELSE MAXTRES=.28 

340 PRINT MAXTRES 

350 PRINT FNC$(22,1);CHR$(27)"K"; 

360 INPUT"Enter Renal Blood Flow Level to Regulate to <650> ",AN$ 

370 IF LEN(AN$)<>0 THEN FLOW=VAL(AN$) ELSE FLOW=650 
380 PRINT FLOW 

390 FLOW0=FLOW'save set value 
400 PRINT FNC$(22,1);CHR$(27)"K"; 

410 INPUT"Enter Glomerular Filtration Pressure to Regulate to <50> ",AN$ 

420 IF LEN(AN$)<>0 THEN GFP=VAL(AN$) ELSE GFP=50 
430 PRINT GFP 

440 GFP0=GFP'save set value 

450 PRINT FNC$(20,1);CHR$(27) n K";CHR$(7); 

460 PRINT FNC$(22,1);CHR$(27)"K"; 

470 PRINT FNC$(24,1);CHR$(27)J"KEnter a RETURN to RESET values "; 

480 PRINT FNC$(21,1);CHR$(27)"K"; 

490 INPUT"Enter Renal Arterial Blood Pressure ",AN$ 

500 IF LEN(AN$)<>0 THEN RBP=VAL(AN$) ELSE 170 
510 GFP=GFP0:FLOW=FLOW0'restore set values 

520 IF RBP<=GFP THEN PRINT CHR$(7);:PRINT FNC$(24,1);CHR$(27)"pPhysiological 
Reserve Exceeded"CHR$(27)"q''; :GFP=RBP 
530 IF RBP<=0 THEN PRINT CHR$(27) n pNo Pressure for FL0W"CHR$(27)"q": 

FOR 1=1 TO 1000:NEXT:GOSUB 800:GOTO 470 
'pause and redirect program flow 
540 GOSUB 610'calculate resistances 
550 GOSUB 1100'check on resistances 
560 IF SW>0 THEN GOSUB 1200'do the recalculation 
570 GOSUB 700'display values over picture labels 
580 GOTO 470 

590 'All Routines are below - MAIN above 

600 'Routine calculates the initial values 

610 TRES=RBP/FLOW 

620 DROP=RBP-GFP 

630 AFFRES=DROP/FLOW 

640 EFFRES=TRES-AFFRES 

650 RETURN 

660 'Displays the values calculated add cursor 
670 'positions for your picture. Add FNC$(R,C) 

680 'for row and column positions in picture. 

700 PRINT FNC$(9,68);CHR$(27) n p";: 

PRINT USING"#####,";RBP;:PRINT CHR$(27)"q n ; 

710 PRINT FNC$(6 ,43);CHR$(27)"p n ;: 

PRINT USING"#.###";AFFRES;:PRINT CHR$(27)"q"; 

720 PRINT FNC$(11,43);CHR$(27) n p";: 

PRINT USING"#.###";EFFRES;:PRINT CHR$(27)"q"; 


program prints the values (in reverse 
video) to fit into the picture. (See lines 
710-750.) 

Drawing the picture is easy, a lot easier 
than copying lines of unintelligible cursor 
commands from a listing—in this case, 
lines 820 through 1080. (Figure 5 shows a 
printer output of the screen display.) 

It s more enjoyable using Ed-A-Sketch 
from The Software Toolworks. With Ed- 
A-Sketch, you can draw the picture on 
the screen and save it as a BASIC file, 
PICTURE.BAS. Renumber its lines to con¬ 
form with Listing 2, save it as an ASCII 
file, and merge it with the program. That 
is what I did to get lines 820-1080. 

(For a review of Ed-A-Sketch, see 
Sextant #9, March-April 1984, “Drawing 
on Your Heath/Zenith Computer: Ed-A- 
Sketch,” by Lee C. Syer.) 

Under Ed-A-Sketch, the picture can 
have “holes” in it; these allow items in the 
background to show through. The simula¬ 
tion program can place the various values 
in the locations allowed by the “holes”. 

You can also save the picture in Ed-A- 
Sketch’s “picture format.” (This requires 
you to erase the “holes” and save the 
picture with “relative cursor addressing.” 
See the Ed-A-Sketch manual.) Using pic¬ 
ture format, you could save the picture as 
PICTURE.PIC. Then, you would replace 
lines 800-1090 with the lines found in 
Listing 3. 

Either way, the Ed-A-Sketch output is 
then suitable for use with the program. 


H89 & H150 
SPEED DOUBLER 

STOP waiting! Increase your 
computer’s speed NOW! 

Easily installed — 

NO trace cuts 
or permanent mods. 

HI 50/160 

•Runs at 6.77 or 4.77 MHz 
•Socketed crystal 
•Hardware reset included FREE 
•Assembled and tested. $34.95 

H89 

•Software-select 2- or 4-MHz 
•Supports Heath, Magnolia, CDR 
CP/M, and HDOS 
•4-MHz Z80A included 

•Assembled and tested. $34.95 

•Complete kit with s/w. $24.95 

•Bare board with s/w.$20.00 

ORDER NOW! 
WRITE OR CALL: 

Micronics Technology 
449 Barbados Way 
Niceville, FL 32578 
(904) 897-4257 

We accept checks, Visa, MasterCard. 
Add $2 shipping. 
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730 PRINT FNC$(l6,48);CHR$(27)"p";: 

PRINT USING"#.###";TRES;:PRINT CHR$(27)"q"; 

740 PRINT FNC$(6,6l);CHR$(27)"p";: 

PRINT USING"#####,";FLOW;:PRINT CHR$(27)"q"; 

750 PRINT FNC$(10,30);CHR$(27)"P";: 

PRINT USING"#####";GFP;:PRINT CHR$(27)"q"; 

760 RETURN 

800 WIDTH 255 

810 PRINT CHR$(27)"E" 

820 PRINT CHR$(27);"w";CHR$(27); n H";CHR$(27); n J n ;CHR$(27); n G"; 

830 PRINT CHR$(27);"q";CHR$(27);"YI2REGULATI0N OF INTRA-GLOMERULAR PRE"; 
840 PRINT "SSURE";CHR$(27); n F";CHR$(27); n Y#JRESISTANCES";CHR$(27);"Y$ "; 
850 PRINT " ";CHR$(27);"Y$N ";CHR$(27);"Y$4 "; 

860 PRINT CHR$(27);"C{{{{{{{{{{{{{{{{{";CHR$(27);"Y$N ";CHR$(27);"Y$XF"; 
870 PRINT "LOW";CHR$(27);"Y&4i";CHR$(27);"G";CHR$(27);"CUUUUUUUUUUUUUU"; 
880 PRINT "UUU";CHR$(27);"F!";CHR$(27);"Y&K{{{{{{{{{{";CHR$(27);"Y&W<="; 
890 PRINT "=====";CHR$(27);"Y‘‘ ";CHR$(27);"G";CHR$(27);"C<== "; 

900 PRINT CHR$(27);"Fi";CHR$(27);"G";CHR$(27);"Y l :<===== "; 

910 PRINT CHR$(27);"C ";CHR$(27);"Feaaai";CHR$(27);"Gafferent"; 

920 PRINT CHR$(27);"Fiaaaaaaaaa";CHR$(27);"Y(4i";CHR$(27);"C|"; 

930 PRINT CHR$(27);"Y(Gfaaaaaaaaaaaaaaaaaaaaaa ";CHR$(27);"GRBP "; 

940 PRINT CHR$(27);"Y)‘filtrate";CHR$(27);"C<==";CHR$(27);"F"; 

950 PRINT CHR$(27);"Ci";CHR$(27);"Y)8 GFP ";CHR$(27);"Y)G|";CHR$(27); 

960 PRINT "Y)J ";CHR$(27);"G";CHR$(27);"Y)Zrenal arterial"; 

970 PRINT CHR$(27); n F";CHR$(27);"Y*4i";CHR$(27); n C|";CHR$(27);"Gintra-"; 
980 PRINT "glomerular";CHR$(27); "F j";CHR$(27);"G";CHR$(27);"Y*Zblood p"; 
990 PRINT "ressure";CHR$(27);"Y+0<==";CHR$(27);"F";CHR$(27);"Ci"; 

1000 PRINT CHR$(27);"Y+7 ";CHR$(27);"Gpressure ";CHR$(27);"F"; 

1010 PRINT CHR$(27);"Y+Geaaaaaaaaaaaaaaaaaaaaaa";CHR$(27);"Y,4i"; 

1020 PRINT CHR$(27); n C|";CHR$(27);"G";CHR$(27);"Y,;=====> "; 

1030 PRINT CHR$(27); n F";CHR$(27);"Y,Gfaaai";CHR$(27);"Gefferent"; 

1040 PRINT CHR$(27);"Fiaaaaaaaaa";CHR$(27);"Y-4i";CHR$(27);"G"; 

1050 PRINT CHR$(27);"CUUUUUUUUUUUUUUUUU";CHR$(27); n Fj";CHR$(27);"Y-J zz"; 
1060 PRINT "zzzzzzzz";CHR$(27);"Y-WFLOW ===>";CHR$(27); n Y.4 "; 

1070 PRINT CHR$(27);"Czzzzzzzzzzzzzzzzz";CHR$(27); n Y0KTOTAL RESISTANCE"; 
1080 PRINT CHR$(27); n G";CHR$(27); n q n 
1090 RETURN 

1100 SW=0‘set switch off and then check resistances for bounds 
1110 IF AFFRES>MAXAFF THEN AFFRES=MAXAFF:SW=SW+1‘set switch 
1120 IF EFFRES<MINEFF THEN EFFRES=MINEFF:SW=SW+1‘set switch 
1130 IF TRES>MAXTRES THEN TRES=MAXTRES:SW=SW+1 
1140 RETURN 

1200 SW=0'trip switch, then recalculate resistances 

1210 TRES=EFFRES+AFFRES‘check and see if too big 

1220 IF TRES>MAXTRES THEN TRES=MAXTRES‘it was so fix it 

1230 IF DROP<0 THEN DROP=0‘negative values no good here 

1240 FLOW=RBP/TRES‘now redo the flow 

1250 AFFRES=DROP/FLOW'in case it is inconsistent 

1260 IF AFFRES>MAXAFF THEN AFFRES=MAXAFF 

1270 EFFRES=TRES-AFFRES 

1280 (FP=RBP-AFFRES»FLOW 

1290 IF DROP=0 THEN GFP=RBP 

1300 RETURN 


Do You Have a Simulation in Mind? 


Now that we’ve been through this 
exercise in biology, you may wonder 
whether the ideas used here can be 
used in some other simulation. To 
answer that question, you might con¬ 
sider a list of narrower questions: 

1. Can the process be described in 
reasonably straightforward mathe¬ 
matical terms? If so, it’s probably a 
candidate for simulation. 

2. Are there a number of different 
factors at work? If so, it would probab¬ 
ly be beneficial to put the process on a 
computer and automate the manipula¬ 
tion of those factors. 

3. Are there any important limiting 
factors? This may take some head 
scratching. MINEFF and MAXAFF are 
integral to the working of GFP.BAS. To 
simplify the program, I had to know 
beforehand that efferent resistance 


couldn’t go below a certain point, and 
afferent resistance couldn’t go above a 
certain point. 

(But if I wasn’t sure—then how 
would I have written the program? 
Ideally, you have to be able to guess 
what is happening before you can 
simulate something. Most of the time, 
the writing of a simulation tells you 
that you don’t really know what is 
happening; your first ideas just don’t 
work at all.) 

I suppose that all you need to know 
is what you think is happening. If you 
can draw a diagram of the process, you 
can simulate it, whether you know the 
“mathematical equations” or not. It is 
the process that is of greatest im¬ 
portance. You can work out the details 
as you go along, if you have some idea 
of the process. 


. . . and from a screen dump 

Another possible way to add a picture 
to the program is with a screen dump. 

Siebert Ickler wrote a very effective 
screen dump in CP/M assembly lan¬ 
guage. (See “Screen Dump!” in Sextant 
#9.) If you haven’t assembled this 
program yet, then use this as an excuse to 
do it. To copy the listing and put it 
into operation takes all of about thirty 
minutes. 

With Ickler’s FSDISK.COM on your disk, 
take your terminal “offline.” Do this with 
the button in the upper left-hand corner 
of the H89, the one that sometimes gets 
you into trouble when it’s down and you 
don’t know about it. 

Draw the picture on the screen. This is 
easiest to do if you reconfigure the keypad 
to give you direct cursor control with the 
arrow keys. The command is ESCape t. To 
turn on the graphic characters, the com¬ 
mand is ESCape F. To turn graphics off, 
use ESCape G. (Remember that ESCape 
sequences are case sensitive.) 

In the graphics mode, the terminal 
does wonderful things to most of the 
lowercase letters. When you have copied 
the picture, move the cursor to the 25th 
line. The command ESCape xl enables 
the 25th line. The command ESCape Y8 
moves you there. At this point, you 
should go back “on line”. (For more on 
controlling the terminal features, see the 
Operation section, section 5, of your ’89 
manual.) 

Depress RETURN to recover the CP/M 
prompt, and then enter the command 
FSDISK PICTURE.PIC. After the screen dis¬ 
turbance stops, go off line and give the 
command ESCape z to reset the terminal 
to its power-up configuration and cancel 
any previous commands. 

That last command will prevent your 
being “trapped” on the 25th line, a most 
distressing position to be in. (Try elimi¬ 
nating the 25th line sometime when your 
cursor is placed there. Use ESC yl to do 
so, and keep a cool head.) 

You can look at your picture by giving 
the command TYPE PICTURE.PIC. The pic¬ 
ture can now be read into the program; 
use the lines given in Listing 3 to access 
the file, as discussed above for Ed-A- 
Sketch’s picture format. 

GFP.BAS , line by line 

GFP.BAS (Listing 2) can be broken into 
modules rather easily, so tracing its logic 
should be straightforward. 

Lines 10-160 take care of preliminaries 
such as giving the user a brief introduc¬ 
tion to the program. The major point of 
interest here is line 20. This defines the 
function FNC$(R,C) to hold the ’89’s direct 
cursor addressing codes and receive the 
row and column specifications given 
when we have to write to particular 
screen locations. 

Line 170 sends us down to the screen¬ 
drawing routine, and lines 180-500 ac- 
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cept user input for the various values. 
Lines 510-520 tell us if we ve exceeded 
the kidney’s limits. Lines 540-580 call the 
various subroutines that take care of the 
calculations. 

The heart of the program, the formulae 
discussed above, is in lines 610-640. 

The subroutine at lines 700-760 prints 
the calculated values in the appropriate 
locations on the screen, and the sub¬ 
routine beginning at line 800 prints the 
screen display itself. 

The code for the two routines in lines 
1100-1140 and 1200-1300 just checks to 
make sure that we did not exceed any of 
the specified limits. 

Only a start 

Well, you have the program. Are you 
ready to try it out? 

Start with the default values, which 
include a desired GFP of 50 mmHg. Give 
it a blood pressure below 50. This is insuf¬ 
ficient pressure, and it will ring the bell. 
The program will calculate GFP to be less 
than 50; in such cases, the program will 
display GFP as just what you entered for 
blood pressure. Obviously the system can 
not compensate if the blood pressure is 
too low. 

With increasing blood pressure, the 
GFP will hold constant until the pressure 
gets too high. The thing to watch at this 
point is the blood flow. At blood pressures 
above 90 and below 200, flow will hold 
fairly steady. 

To see how this is accomplished, watch 
the changes in afferent and efferent resis¬ 
tances. The total resistance will rise with 
pressure until a maximum is reached. It is 
then that autoregulation starts to fail on 
the upward side of the pressure range. 

You can verify that by changing the 
value of the maximum TRES at the start of 
the program. You can also change the flow 
rate and the desired GFP and observe 
what this does to the range over which 
autoregulation can occur. 

Changing the range of possible resis¬ 
tance will obviously change the ability to 
autoregulate. But I think you will also 
find that the flow of blood and the desired 
GFP are critical to the range of autoregula¬ 
tion. Why not? It’s built into the very 
math. 

But it’s easy to say that after fooling 
around with the model—not before. The 
moral: simulations help to confirm intui¬ 
tive ideas. I had no idea that the sheer 
amount of blood flow could act as a signifi¬ 
cant limiting factor until I did this little 
simulation. It taught me something about 
my own field. 

This simulation example, of course, 
would be only the start for representing 
all of the many regulatory operations of 
the kidney. As factors are taken into 
consideration, the model would be ex¬ 
panded. 

These enhancements I leave to readers 
who wish to pursue the subject further. 


Others, I hope, will want to simulate 
processes in other fields. Either way, let 
each step stimulate you to the next step. 
After many steps, you may have learned 
more about how something works than 
before you started. 

Simulations are stimulating! 


Additional Information 

Ed-A-Sketch, $29.95. 

The Software Toolworks 
9713 Santa Monica Blvd., Suite 204 
Beverly Hills, CA 90210 
800/223-8665; in California, 


800/228-8665 


Enter Renal Arterial Blood Pressure 100 

Renal Arterial Pressure 100 
Afferent Glomerular Resistance .0784616 
Efferent Glomerular Resistance .0784616 
Total Renal Resistance to Blood Flow .156923 
Total Renal Blood Flow 637.255 
Glomerular Filtration Pressure 50 


Enter a RETURN to RESET values 

Enter Renal Arterial Blood Pressure 150 

Renal Arterial Pressure 150 
Afferent Glomerular Resistance .155897 
Efferent Glomerular Resistance .0779487 
Total Renal Resistance to Blood Flow .233846 
Total Renal Blood Flow 641.447 
Glomerular Filtration Pressure 50 


Figure 4. This would 
be the output from a 
“stripped down” 
version of GFP. BAS 
without any graphic 
representation. The 
underscored numbers 
indicate user input. 
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Figure 5. Appearance of the screen display of GFP. BAS (Listing 2). The numbers along the 
edge represent row and column positions, and can be used to create a separate graphics 
file (as described in the text). 


800 OPEN "I", 1 ,"PICTURE.PIC" 

810 PRINT CHR$(27)"E":WIDTH 255 
820 WHILE NOT E0F(1) 

830 LINE INPUT#1,D$ 

840 PRINT D$ 

850 WEND 
860 CLOSE#1 
870 RETURN 


Listing 3. You may wish to create a separate graphics file to contain the screen display for 
GFP. BAS (see text). If so, these lines can replace lines 800 to 1090 of Listing 2. 
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GIVES YOU 


FOR YOUR 

BUCK! 






CCS-2000 
Winchester Disk 
System 




By using the most popular Winchester con¬ 
trol protocol available (the ST-506), we bring 
you Winchester storage capability at the 
lowest price in the history of Zenith Z-100 
computing . Time-proven components are 
combined with the latest in technology to 
give you the best price/performance in mass 
storage for the Z-100. 

The software interface to the Winchester drive is 
implemented via a device driver. This means you 
must first boot the system off your floppy drive. 
After booting, our software will allow you to use 
the Winchester with ease. The $500, or more, 
saved by the CCS-2000 is well worth the slightly 
longer boot procedure. 

We currently support the MS-DOS 2.x operating 
systems. We are now developing support drivers 
for MS-DOS 3.x. In addition, we are currently 
developing support for drive partitions and multi¬ 
ple drives. We will provide registered users with 
free software updates for a period of one year after 
the date of purchase. 


20 Megabytes of Win¬ 
chester disk storage 
Compatible with all 
Z-l 00 series computers 
Lowest hard disk cost in 
Zenith Z-100 history 
$749.00for a complete 
20 Mbyte system 


Choose one of two drives with our base system, 
the CMI CM-3426 or the Seagate ST-225. We 
also offer, for a premium of $100, the new Lapine 
Ranger; a 3V4 ", 20 Mbyte drive with increased 
reliability due to small size and to technology that 
assures no head-to-disk contact ever. We have 
used and sold all our drives for over a year 
without a single failure. We recommend them 
without hesitation. 


Manufacturers Specifications 

Drive 

Access 

Time 

Start 

Power 

Running 

Power 

MTBF 

CM-3426 

80 ms 

30 Watts 

15 Watts 

20,000 Hr 

ST-225 

80 ms 

38 Watts 

15 Watts 

11,000 Hr 

Ranger 

65 ms 

25 Watts 

13.5 Watts 

28,000 Hr 


More Bytes From: 


am 


CUSTOM COMPUTER SYSTEMS 

P.O. Box 797 
810 Blue Mountain Rd. 

Lyons, Co. 80540 

(303) 823-5394 
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Patching Word's .prim 
Files for More Printer 
Features 

Microsoft Word supports some of the capabilities of many different printers. 
One user found out how to make it even more versatile. 

Ken Daniel 


One of the strong points of Microsoft 
Word is the extensive printer support it 
offers. Users of Word, then, may have felt 
the same surprise as I did upon discover¬ 
ing that Word fails to support some of the 
most popular printers to their full capa¬ 
bilities. 

For example, my Okidata 92 dot-matrix 
printer is capable of printing in near¬ 
letter-quality at 12-pitch. (This capability 
is sacrificed if the 92 has the “Plug and 
Play” chips installed.) But the combina¬ 
tion of 12-pitch and “correspondence” 
quality is not supported by the Oki 92 
printer driver (OKI92.PRD) supplied with 
Word. Similarly, Word s driver for the 
daisywheel Qume Sprint 11 will not sup¬ 
port 15-pitch (useful for printing wide 
tables) although the printer is capable 
of it. 

Selecting fonts 

Microsoft Word’s printer drivers are 
supplied in the form of files having the 
extension .PRD. Each .PRD file supports a 
set of “fonts”; using the PRINT OPTIONS 
command within Word, you can attach a 
font to a document wherever desired, on 
a character-by-character basis if needed. 

Invoking one of these fonts simply 
amounts to sending to the printer the 
appropriate control-code sequence asso¬ 
ciated with the desired printer font. 

Fonts are selected from a set of options 
provided by Word, such as Pica for 10- 
pitch draft or PicaC for 10-pitch corre¬ 
spondence quality. With the Oki 92 
printer option selected, there is an Elite 
font for 12-pitch draft, but no EliteC 
for correspondence quality. There is an 
EliteD for double strike. So the problem 
is to get the printer to print as if Word had 
an EliteC font. 

Microsoft supplies a utility program 


Ken Daniel is a research engineer at 
the Washington , D.C., office of the 
Environmental Research Institute of 
Michigan. 


called CONVPRD.COM for converting the 
.PRD files into ASCII text files. These text 
files can be modified, and then be 
reconverted to binary incorporating your 
patches. The Word manual offers a de¬ 
scription of the form and contents of the 
.PRD file structure. But even with these 
explanations, the actual way to do the 
patching remains a bit obscure—espe¬ 
cially because of the use of some 
undocumented control-code representa¬ 
tions used in the ASCII version of the 
.PRD text file. A call to the Microsoft 
technical support staff cleared up these 
secrets to the extent that I needed, and 
this experience is offered here to help 
others who may have similar require¬ 
ments. 

The .PRD files 

The .PRD files are composed of seven 
sections: (a) header, (b) font directory, 
(c) font descriptions, (d) character-width 
table, (e) character-translation tables, 
(f) printer-control sequence descriptions, 
and (g) printer-control sequences. These 
sections can be identified when the .PRD 
file has been converted to ASCII. Listing 
1 shows the text output from running 
CONVPRD.COM on OKI92.PRD. 

As can be readily seen from looking at 
Listing 1, the meanings of these various 
codes are not immediately obvious— 
even if you have a good knowledge of the 


printer that this definition file is 
supposedly controlling. 

In adding font definitions, the areas of 
interest to us are the segments enclosed 
within braces having the general form of 
{F#. . .}F. In Listing 1, the Pica font (FO) 
definition is enclosed within the first set 
of braces; it occupies 21 lines of text plus 
spaces separating the different sizes. The 
second font that is defined (FI) is the 
double-strike Pica font; it is followed by 
the font definitions for Elite (F2), double¬ 
strike Elite (F3), and correspondence- 
quality (near-letter-quality) Pica (F4). 

Adding a new definition 

Our goal is to add a new font definition 
that we will call EliteC, a 12-pitch equiv¬ 
alent of PicaC. The problem is in deter¬ 
mining what goes in this definition, and 
the difficulty is caused by Microsoft’s 
cryptic coding of the printer control 
sequences. Table 1 provides a decoding of 
these symbols as applicable to the Oki 92. 
It should not be hard for you to make 
appropriate adjustments for your own 
printer codes. 

What Table 1 shows is that the 
CONVPRD program takes the various 
codes needed by the Oki and converts 
them into ordinary ASCII text. The 
Escape code (ctrl-[, decimal value 27), 
for instance, is changed to the ASCII 
symbols A [. The ASCII symbols A A in- 


Mode 

Symbol 

Control Code 

Cancel 

A A 

RS (decimal 30) 

12-pitch 

A \ 

FS (decimal 28) 

Correspondence quality 

A [1 

ESCape 1 

Draft quality 

A [0 

ESCape 0 

Emphasis 

A [H 

ESCape H 

No emphasis 

A [I 

ESCape I 


Table 1. Printer codes for the Okidata 92. 


Sextant November-December 1986 59 





dicate CTRL- A the code to reset the Listing 1. Running CONVPRD.COM on OKI92.PRD produces this text output. This is the 
Okidata 92 and so forth. ASCII version of the coded information contained in the OKI92.PRD file. 

We need to study the way that the . PRD 
file commands a transition from Pica to 
PicaC (from draft mode 10-pitch to cor¬ 
respondence-quality 10-pitch), and from 
Elite to EliteD (draft mode 12-pitch to 
double-strike or emphasized 12-pitch). 

From this, we can derive a structure for 
going into correspondence mode and 12- 
pitch. 

The EliteD definition (F3) is the key: it 
must go from the default 10-pitch draft 
mode to both emphasized mode and 12- 
pitch while defining font size options, as 
will our proposed EliteC. 

The Oki manual tells us that going to 
12-pitch requires the decimal code 28 
( A \) to be sent to the printer; it also tells 
us that emphasized mode requires an ESC 
H ( a [h). So, we can simply copy the 
entire EliteD definition, substituting the 
code for correspondence quality (ESC l 
from the Oki manual) for the ESC H. 

All other measurements will remain 
the same, since the font sizes are the 
same. These sizes are given in “printer 
points,” where a printer point equals 
1/120". (In printers, this is frequently 
used as the minimum stepping incre¬ 
ment.) For instance, 10-pitch corres¬ 
ponds to 12 printer points per character, 
while 12-pitch corresponds to 10 printer 
points. Further, the 12-pitch (10-point) 
font has a double-width option of 20 
points. 

Yes, it can be confusing—and a bit 
more so when you note that the Word 
manual says that a “point” equals 1/72". 

That, however, reflects the definition of 
the term “point” as used by typeset¬ 
ting companies—not by manufacturers of 
printers. 

We do not want our 12-pitch font sizes 
to be any different from those with em¬ 
phasized printing; the appropriate scal¬ 
ing with respect to the Pica font can be 
seen with a little study. 

Editing the .PRD file 

So, we can simply edit the ASCII ver¬ 
sion of this OKI92.PRD file with a word 
processor, making sure that we save it as 
“plain-vanilla ASCII.” (With Word, this 
can be done using TRANSFER SAVE 
“Unformatted.”) Copy the {F3 lines 
(EliteD) into the area below the {F4 lines 
(PicaC), and make the following text 
changes: 

1. Change the first line to {F5. 

2. Change the H in both “beginmod” 
lines to a 1. 

3. Change FontName from EliteD to 
EliteC. 

What we will have done is replicate the 
emphasized-font control sequence, sub¬ 
stituting ESC 1 for the ESC H, thus giving 
correspondence quality instead. Since we 
did not destroy the EliteD section of the 
description, that font is still available, but 
we now have (at the end of the font 
description section) the additional de- 


CONVPRD 1.10 
dxaMin:12 dyaMin:10 

PrinterType:1 Microspace:1 SpecialFlags:0 Seriallnterface:40960 
{F0 

CTP:T0 
cPSDs:4 

FontSize:16 
Wtps:7 7 7 7^ 
beginmod:0 n ~] n 
endmod:0 

FontSize:24 
Wtps:12 12 12 12 
beginmod:0 
endmod:0 

FontSize:28 ; 

Wtps:14 14 14 14 
beginmod:0 n 
endmod :0 n ^ n 

FontSize:32 
Wtps:24 24 24 24 
beginmod:0 n ~_ n 
endmod:0 tl *~ n 
FontName:Pica 
}F 

{FI 

CTP:T0 
cPSDs:4 

FontSize:16 
Wtps:7 777 

beginmod :0 "~]~[H W 
endmod:0 

FontSize:24 
Wtps:12 12 12 12 
beginmod :0 TT ~[H n 
endmod:0 »*[I» 

FontSize:28 
Wtps:14 14 14 14 
beginmod :0 " ~]R" 
endmod :0 

FontSize:32 
Wtps:24 24 24 24 
beginmod:0 
endmod:0 «*[i**" 

FontName:PicaD 
}F 

{F2 

CTP:T0 
cPSDs:2 

FontSize:20 
Wtps:10 10 10 10 
beginmod:0 
endmod:0 

FontSize:30 
Wtps: 20 20 20 20 
beginmod:0 
endmod :0 
FontName:Elite 
}F 

{F 3 

CTP:T0 
cPSDs:2 

FontSize:20 
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Wtps: 10 10 10 10 
beginmod:0 "*\ A [H" 
endmod:0 

FontSize:30 
Wtps:20 20 20 20 
beginmod :0 
endmod:0 
FontName:EliteD 
}F 

{F 4 

CTP:T0 

cPSDs:2 


FontSize:24 
Wtps:12 12 12 12 
beginmod:0 "'Tl" 
endmod:0 "~[0" 

FontSize:32 
Wtps:24 24 24 24 
beginmod :0 " ~[ i 
endmod:0 "~~[0" 
FontName:PicaC 
}F 

{T0 

cCSD:1 chFirst:128 chLast:175 


128:67 44 

129:117 34 

130:101 39 

131:97 94 

132:97 34 

133:97 96 

134:97 0 

135:99 44 

136:101 94 

137:101 34 

138:101 96 

139:105 34 

140:105 94 

141:105 96 

142:65 34 

143:65 0 

144:69 39 

145:97 0 

146:65 0 

147:111 94 

148:111 34 

149:111 96 

150:117 94 

151:117 96 

152:121 34 

153:79 34 

154:85 34 

155:99 47 

156:35 0 

157:89 61 

158:80 0 

159:102 0 

160:97 39 

161:105 39 

162:111 39 

163:117 39 

164:110 126 

165:78 126 

166:97 95 

167:111 95 

168:168 0 

169:169 0 

170:170 0 

171:171 0 

172:172 0 

173:173 0 

174:60 61 

175:62 61 


}T 

{P 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 

}P 

E 


:0 mod:0 "~X" 

:4 mod:0 

:8 mod:2 magic:0 value:99 n ~[F n 
:14 mod:0 

:18 mod:0 magic:0 value:127 n *[$9" 
:24 mod:0 

:28 mod:0 magic:0 value:0 

:34 mod:0 

:38 mod:0 

:42 mod:0 

:46 mod:0 

:50 mod:0 

:54 mod:0 

:58 mod:0 

:62 mod:0 

:66 mod:0 


mod :0 

IT 



mod :0 

"~[I" 



mod: 4 




mod: 0 




mod :0 

magic: JO 

value:0 

"'[C 1 

mod :0 

"~[D" 



mod: 2 

magic:0 

value:0 


mod :0 




mod: 2 

magic:0 

value: J0 

" A [C 

mod :0 

"~[D" 



mod:0 

magic: J0 

value:0 

"'[J 1 

mod :0 

"~[L" 



mod :0 

magic:0 

value: J0 

"'[L 1 

mod:0 

"~[J" 




{F5 

CTP:T0 
cPSDs:2 

FontSize:20 
Wtps:10 10 10 10 
beginmod :0 n *\ A [1" 
endmod :0 » A [I AA " 

FontSize:30 
Wtps:20 20 20 20 
beginmod :0 n*\*j*[ -jn 
endmod:0 "''[I''*" 
FontName:EliteC 
}F 


Listing 2. Adding this font descriptor to 
your OKI92.PRD file (Listing 1) will add a 
12-pitch, correspondence-quality mode to 
your printer options. 


scrip tor given in Listing 2. 

The final step is to reverse the 
CONVPRD process. Run CONVPRD.COM 
with the modified text file. When the 
program prompts you, name the new 
.PRD file something like OKI92NEW.PRD, so 
as not to destroy the old one until you 
have checked things out. Make sure the 
new . PRD file is on the same drive as your 
other Word program overlays, etc. 

Checking it out 

To check out the new font, perform 
PRINT OPTIONS; hit one of the arrow keys 
to bring the menu of possible choices onto 
the screen. If you didn’t make any 
mistakes, the list of options should in¬ 
clude the OKI92NEW printer selection. 

After choosing the new option, you can 
attach the EliteC font to any part of your 
text. Select all or a section of your docu¬ 
ment, perform FORMAT CHARACTER, tab 
to the font-name field, and hit one of the 
arrow keys to bring the menu of possible 
font choices onto the screen. You should 
see EliteC as one of the choices. Select it 
and tab to the font-size field of the FOR¬ 
MAT CHARACTER menu. Again using the 
arrow keys to bring up the possible 
choices, you should see the option for 10 
points, which corresponds to 12-pitch. 
Select this option and return to the main 
command line. Printing the document 
should result in 12-pitch correspon¬ 
dence-quality print. 

Remember, Oki 92s that have the “Plug 
and Play” chips installed have sacrificed 
the ability to run 12-pitch under any 
circumstances; so don’t forget this one 
caveat to this whole process. 

The technique described here can be 
applied to customize other printer 
drivers for Microsoft Word. I have not 
addressed all of the customizations 
possible using the CONVPRD program, 
such as modifying the character-transla¬ 
tion tables; but I hope that this discussion 
will let you probe the mysteries of Word’s 
printer drivers in a useful way. A 
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BOOKS FROM SEXTANT PUBLISHING COMPANY 


Heath/Zenith Users: 

Now you can get the books you 
need to make your time on the 
computer more productive—and 
at drastically reduced prices! 


For a limited time, Sextant Publishing 
Company has lowered prices on the 
popular FlipFast Guides to Zenith/Heath 
MS-DOS/Z-DOS and Zenith/Heath 
CP/M-80/85. As an added bonus, we’ll 
send you a FREE copy of How to Use: 
Zenith/Heath Computers, when you buy 
two or more of the FlipFast Guides\ 


You can buy any combination of the 
FlipFast Guides to get your FREE copy 
of the How to Use: Zenith/Heath 
Computers book—two MS-DOS books, 
two CP/M books, or one of each. You 
just have to buy two books —at their 
new low prices —to get one book 
FREE! 


ORDER YOUR BOOKS TODAY! 

Use the card attached above to order your FlipFast Guides 
and your FREE copy of How to Use: Zenith/Heath Computers ! 




Published at $12.95 
Now only $7.95 


Published at $19.95 
Now only $12.95 


Published at $19.95 
Now FREE with purchase 
of two FlipFast Guides 
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Name_ 

I want to get Address 

the most out of 
my operating system! 


—--- □ 

md me □ 

Zenith/Heath MS-DOS/Z-DOS 

copies @$1 2.95each = $ _ 

Zenith/Heath CP/M-80/85 □ 

_copies @ $7.95 each = $_ 

4- $2.50 shipping charge 

per order in U.S,/Canada — $_ 

or 

4- $4.00 shipping charge 
per book sent overseas = $_ 

Total = $ _ 


Payment enclosed (checks must be in 
U.S. dollars payable on a U.S. bank) 
Charge my: □ VISA □ MasterCard 

Card # _ 

Expires _ 

I’m buying two FlipFast Guides—send me 
my FREE copy of the book, How to Use: 
Zenith/Heath Computers. (For books sent 
overseas, please add $4.00 shipping charge 
to your payment.) 


Mail this card today to: 
Sextant Publishing Company 
716 E Street, S.E. 
Washington, DC 20003 


25-M/C 


I want to get 
the most out of 
my operating system! 


end me 

Zenith/Heath MS-DOS/Z-DOS 

_copies @$12.95each = $ _ 

Zenith/Heath CP/M-80/85 

_copies @ $7.95 each = $ _ 

+ $2.50 shipping charge 
per order in U.S./Canada = $_ 
or 

+ $4.00 shipping charge 
per book sent overseas = $ _ 

Total = $ _ 


Name _ 
Address 


□ Payment enclosed (checks must be in 
U.S. dollars payable on a U.S. bank) 

□ Charge my: □ VISA □ MasterCard 

Card # __ 

Expires_ 

□ I’m buying two FlipFast Guides—send me 
my FREE copy of the book, How to Use: 
Zenith/Heath Computers. (For books sent 
overseas, please add $4.00 shipping charge 
to your payment.) 


Mail this card today to: 
Sextant Publishing Company 
716 E Street, S.E. 
Washington, DC 20003 


25-M/C 








































Send me the FlipFast Guide 
to my Heath/Zenith operating system: 



□ Zenith/Heath 
MS-DOS/Z-DOS 


256 pages 



□ Zenith/Heath 
CP/M-80/85 


190 pages 


Each guide features 

• Easy-to-access information for Heath/ 
Zenith users 

• Specific information for each operating 
command or subcommand 

• Easy-to-use listings and tables 

• Error message listings 


To order your copies, fill out the revers 
side of this card today and mail it to 
Sextant Publishing Co. 

716 E Street, S.E. 
Washington, DC 20003 


Send me the FlipFast Guide 
to my Heath/Zenith operating system: 



□ Zenith/Heath 
MS-DOS/Z-DOS 


256 pages 



□ Zenith/Heath 
CP/M-80/85 


190 pages 


Each guide features 

• Easy-to-access information for Heath/ 
Zenith users 

• Specific information for each operating 
command or subcommand 

• Easy-to-use listings and tables 

• Error message listings 


To order your copies, fill out the revers 
side of this card today and mail it to 
Sextant Publishing Co. 

716 E Street, S.E. 
Washington, DC 20003 
















The FlipFast Guide to 
Zenith/Heath CP/M-80/85 

By William M. Adney 

For each CP/M command or 
subcommand you’ll find 

• required syntax • typical 
applications • specific examples • 
command requirements • applications 
notes • error message listings 

You can easily refer to listings of 

• CP/M 2.2 system calls 0-40 • BIOS 
jump table • 8080/8085 op codes • 
escape sequences and key functions 

Plus additional technical 
information on 

• the disk parameter block • disk 
parameter headers • file control 
blocks • CP/M memory addresses • 
contents of first page of memory 

Features a 6-page index of error 
messages 

190 pages 

Published in 1984 by S-A Design Books 


The FlipFast Guide to 
Zenith/Heath MS-DOS/Z-DOS 

By William M. Adney 

For each MS-DOS/Z-DOS 
command or subcommand you’ll 
find 

• the name of each command • 
command syntax • a short 
explanation of the typical application 
of the command or subcommand • 
examples that include an explanation 
of command function • a list of 
requirements that illustrate 
correct/optimum command operation 

• application notes about specific 
usage • error message listings 

Appendices provide a FlipFast 
reference to 

• EDLIN and all the EDLIN 
subcommands • a decimal/hex/ 
ASCII/control-key/MS-DOS-call 
conversion chart • a glossary of 
terms 

256 pages 

Published in 1985 by S-A Design Books 


I- 

Send me the books I’ve checked! 

' □ Zenith/Heath MS-DOS/Z-DOS 

| _copies @ $12.95 each = $- 

□ Zenith/Heath CP/M-80/85 

_copies @ $7.95 each = $- 

□ How to Use: Zenith/Heath Computers 

\ _copies @ $19.95* each = $- 

4-shipping charge ($2.50 
I per order in U.S./Canada; 

$4.00 per book overseas) = $- 

i Total Payment = $- 

*Buy any two FlipFast Guides and you 
| get a FREE copy of How to Use: Zenith/ 

Heath Computers. 

I □ Payment enclosed (checks must be in 

U.S. dollars payable on a U.S. bank) 

□ Charge my: _Visa _MasterCard 

Card #- 

Expires_ 

I Name_ 

Address- 


Sextant, Dept. S25, 716 E Street, S.E., Washington, DC 20003 


_ | _ 
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How to Use: 

Zenith/Heath Computers 

By Hal Glatzer 

Here’s the guide to your H8, H/Z89, 
or H/Z100 computer system! Written 
specifically for users, Zenith/Heath 
Computers is both an introduction to 
computing concepts for the novice 
and a reference tool for the expert. It 
also serves as a buying guide for 
new hardware and software. Clear 
presentations of technical information 
are supplemented with photographs 
and illustrations. This is not a 
complicated users’ manual! 

Now, for a limited time, you can get a 
FREE copy of this book! Just order 
two copies of the FlipFast Guides to 
Zenith/Heath MS-DOS/Z-DOS or 
Zenith/Heath CP/M-80/85. Or get 
How to Use: Heath/Zenith 
Computers for $19.95 plus shipping. 

144 pages 

Published in 1982 by S-A Design Books 
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Expand yourjB*®* pc Memory with 



fully loaded with 2 MBYTES\w just *395' 



FASTCARD speeds disk I/O 
by as much as tenfold, 

as shown in the following chart. 


This graph shows benchmark test 
results of a PC equipped with 
FASTCARD versus a PC-XT and 
PC-AT. These tests were run by a 
major independent testing labora¬ 
tory using their standard disk per¬ 
formance benchmark tests. 


Bill 

SPEED 

FASTCARD vs HARDDISK 

, PERFORMANCE DATA 




14 

12 

10 

8 

8 

4 

V 2 

0 

SEQ READ 1 1 

RR 1 SEC 

RR 8 SEC lllllllllllllllll 

RR & SEQ 

■■■ 




IBM XT IBM AT PC + FAi 




Specifically designed for compatibility with the 8 MHz Zenith bus, 
FASTCARD provides both extended and expanded memory plus 
the following standard features: 


•Portable between all Zenith 
models 

•Up to 2MB with Split Memory 
Mapping to 

- Fill memory to 640K 

- Provide Expanded memory 
over 640K 


• Unique Disk Caching 

• Ram Disks (up to 8MB) 

• Custom Password Security 

• Print Buffering 

• Built-in Diagnostics and Automatic 
Fault Tolerance 


*Each FASTCARD III comes with 2 MBytes of memory for $395. FASTCARD IV, 
available with 1 MByte, includes serial/parallel ports and a clock calendar for $299. 
FASTCARD III without memory is $140 and FASTCARD /^without memory is $169. 


For additional -IM; PERIPHERAL MARKETING, INC. (602) 483-7983 
information, call: f'ffff 7825 E. EVANS RD., #600, SCOTTSDALE, AZ 85260 
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C Notes 


Joseph Katz 


Prologue 

Assembler in C 

In-line and external assembly 
language functions 

Assemblers for C functions 

Advanced assembly language 
debuggers 

ASNICE.C: a simple formatter 
for assembly language 
functions 

An assembly language 
bookshelf for C programmers 

Epilogue 


Prologue 

Everyone new to C skips over the 
sections on assembly language in the 
compiler manuals. Their relevance to 
programming in a high-level language 
seems questionable at best. But stay with 
this column for a while and Ill try to set 
things in some perspective. Better even 
than that, I think I can give you an ap¬ 
proach to some tools that eventually 
should help you become at least an ap¬ 
prentice C wizard. 

Assembler in C 

Two of the major reasons for program¬ 
ming in C seem to make assembly lan¬ 
guage an anathema. Because it deals with 
the machine on a low level, assembly 
language is, by nature, not portable. And 
because it is a low-level language, assem¬ 
bler is a fussy way to work, susceptible to 
errors and prone to explode. 

For both reasons, it seems odd to say 
that those serious about C programming 
will eventually need a grasp of the assem¬ 
bly language on their machines. But, in 
fact, that knowledge can determine the 
difference between an intermediate and 
an advanced C programmer. Without it, 
C programmers sooner or later go bump. 
Or maybe it’s only a few of their C 
programs that do. 

And yet there’s no need for apprehen¬ 
sion about the prospect of confronting the 
amount of assembly language you’ll need. 
You don’t need much, and you either 
already have or soon will have the prepa¬ 
ration for what you need. A sound knowl¬ 
edge of C provides excellent preparation 
for what you’ll want to do: not necessarily 
full-length assembler programs, but func¬ 
tions otherwise unavailable to you. 

All C compilers are accompanied by a 
so-called “standard” library having at 
least low-level functions such as open(), 
close(), read( ), and write( ), and some 
high-level functions such as fopen(), 
fclose(), fread( ), and fwrite( ). All of 
these are operations that can be im¬ 
plemented on any machine, which is why 
the library containing them is called 
“standard”—not because all C compilers 


available for a machine implement the 
same functions the same way. To the con¬ 
trary, one certainty in C programming is 
that different compilers for the same 
machine speak slightly different idioms. 

These considerations are no matter to 
the programmer happily married to one 
machine and one compiler package for it, 
and willing to work within the limits of 
whatever libraries come with that pack¬ 
age. C employs the concept that all 
functions are little “black boxes”—in ef¬ 
fect, magic spells that anyone who knows 
the wizard’s grammar can invoke. There¬ 
fore, it’s not too difficult to accomplish 
useful things in C without much under¬ 
standing of the machine on which the 
program is to run, and often without even 
knowing which machine it will be. 

The catch, of course, is that someone 
else must have written the functions one 
needs to manipulate the machine. Un¬ 
fortunately, most very good C compilers 
for microcomputers do not come with all 
of the machine functions the average 
programmer considers essential. 

Take, for example, a function to clear 
the terminal’s screen, similar to CLS in 
Microsoft BASIC or on the MS-DOS 
command line. It’s a machine-dependent 
function, non-portable, and not supplied 
with most C packages. When it’s unavail¬ 
able, there are only a few reasonable 
options: write programs that never clear 
the screen, clear the screen with line 
feeds, or create the function in assem¬ 
bler. 

Each of those options has its own 
catches. The first makes for a cluttered 
screen, with a program’s output floating 
upwards from somewhere under the ter¬ 
minal. It’s a potentially confusing sight, 
certainly unaesthetic—good enough for 
the programmer’s solitary use perhaps, 
but, even so, an unpleasant way to have to 
live. I think the second option a foul 
choice. The code is given in Listing 1; try 
it and see what you think. Now it s 
newlines that float up from below. Foul, 
right? 

The most satisfactory option is creating 
a function that snaps the screen clear. 


^include <stdio.h> 
main() 

{ 

int i; /* i is a counter */ 

for (i = 0; i <=24; i++) /* increment the counter 25 times */ 

putchar(0x0A); /* send a newline each iteration «/ 

} 


Listing 1. A C routine which clears the computer screen with line feeds. 
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PUBLIC 

CRT_CLS 

; declare it callable 

CRT_CLS PR0C NEAR 

; ’near’ for small memory model 

PUSH 

BP 

; save the frame pointer 

MOV 

BP ,SP 

; current stack position 

;clears 

screen by scrolling page 

MOV 

AX,0600H 

; scroll active page up 

MOV 

CX,0000H 

; from row 0, col 0 

MOV 

DX, 184FH 

; to row 24, col 79 

MOV 

BH,07H 

; use normal attribute on blanked line 

INT 

10H 

; MS-DOS video 1/0 function 

MOV 

SP,BP 

; get starting stack position 

POP 

BP 

; restore the frame pointer 

RET 

_CRT_CLS ENDP 

; restore control to calling program 
; procedure ends here 


Listing 2. An assembly routine which clears the Z150 screen. 


Such a function must work on such a low 
level as almost always to require fiddling 
with the microprocessor registers direct¬ 
ly. So, the language one must use is as¬ 
sembly. Listing 2, for example, shows one 
way to clear the screen on a computer in 
the H/Z150 family. 

You can’t use it yet. The function is 
complete, but to be usable it must be set 
in a context determined by the specific C 
compiler. Each has its own requirements. 
Some, like Computer Innovations’ Opti¬ 
mizing C86, make life simple by provid¬ 
ing assembly language headers. The 
header gives you the code you need to 
declare the memory model (essential be¬ 
cause of the segmented architecture of 
the 8088 microprocessor family); the 
header also gives you a prologue and epi¬ 
logue that together supply the necessary 
context for such functions. 

After you’ve written a function, and set 
it in the proper context, you’ll need tools: 
an assembler, a linker, and—for con¬ 
venience—a librarian, and all of those 
compatible with one another. First, name 
the function something like CLS.ASM, to 
give it the extension required by most 
assemblers. Then run the file through an 
assembler such as Microsoft’s MASM to 
produce a file called CLS. OBJ. The . OBJ file 
is what gets linked into the object code of 
your C program. 

You have two options about when and 
how to link your new .OBJ file: you may 


now link the object file directly into the 
program’s object code, before you tell the 
linker to search function libraries; or you 
may put the object file into a library with 
others of your functions in object form, 
and have the linker search the library for 
functions the program requires. (Some C 
compilers allow no way to link in Micro¬ 
soft-compatible object code—a good rea¬ 
son to avoid them, I think.) 

Using Microsoft’s LINK, the first option 
above would use a command like 
LINK MYPROG + CLS,,, CLIB 
(Your C program is now MYPROG.OBJ, and 
you are linking it directly to our CLS.OBJ 
before having the compiler’s CLIB. LIB 
searched for standard functions.) 

With the same linker, the second op¬ 
tion would take a command like 
LINK MYPROG,,, MYFUNCTS + CLIB 
(The linker searches first your own 
MYFUNCTS. LIB, then the compiler’s li¬ 
brary of standard functions.) 

Convenience is the only consideration 
in which option you choose. Obviously, if 
your programs often draw from a group of 
your own functions, it will be inconven¬ 
ient to keep track of the appropriate com¬ 
mand line, much less to type it over and 
over again. Imagine having to type a com¬ 
mand such as this more than once: 

LINK MYPROG + FUN1 + FUN2 + FUN46 + 
FUN28 + FUN32,,, CLIB 

It’s no fun, especially if it turns out that 
some functions were given in the wrong 


order because, say, FUN2 requires that 
something in FUN46 be defined first. 
Then the command must be revised and 
reissued. 

Putting your functions in a library—in 
the required order, of course—relieves 
you of having to remember much when 
linking except which library to use. It’s 
usually more convenient, therefore, to 
group a collection of such object files 
into a library that might be called 
MYFUNCTS. LIB. An object librarian like 
Microsoft’s LIB will help you perform that 
task. Now you are free to clear the screen 
in any C program just by declaring the 
function crt_cls( ). Then, whenever you 
link any program, include MYFUNCTS. LIB. 
The linker will find any such functions 
that the program requires from the li¬ 
brary and will link them and only them. 
You won’t have to worry about bloating 
the program by linking in any unneeded 
functions from the library because the 
linker has enough intelligence to ignore 
them. 

To repeat, I am not suggesting the need 
to become a full-fledged assembly lan¬ 
guage programmer, someone able to 
write a standalone assembly language 
substitute for the C program. Nor am I 
even edging towards that as a goal. In¬ 
stead I am talking about roughly the same 
step forward in computer literacy as 
when a novice computer user graduates 
from menus. In fact I am talking about 
little more than enough assembly lan¬ 
guage literacy for average C program¬ 
mers to write routines for their own func¬ 
tion libraries. Most of the time these 
routines are not much more trouble than 
preparing a fast meal from recipes in 
a couple of cookbooks. The function 
recipes are in the compiler’s manual and 
in books such as the manual for the 
MS-DOS Version 2 Programmer’s Utility 
Pack and the Programmer’s Reference 
Manual for the Z150. I’ll be doing some 
assembly language functions from time to 
time in future columns, so I’m laying the 
groundwork for them here. 

In-line and external assembly 
language functions 

A few C compilers allow in-line assem¬ 
bly language, which is convenient and 


LEATHERETTE DUST COVERS 


High quality, hand crafted, custom fitted leather¬ 
ette dust covers are available for the following 
listed Heath/Zenith computers and accessories. If 
your H/Z equipment is not listed write for a price 
quotation. Custom dust covers can be manufactured 
if you will provide a diagram with dimensions 
(actual cost will depend on the size of the cover 
and will include a $5 design fee). 


H8, H14, H17, MX-80, ZVM-122/135 $12.95 

H/Z 100 all in one, H/Z 19/89/90 $15.95 

Diablo 630 w/tractor, H/Z-29 $16.95 

H/Z 25/125 $18.95 

H/Z-100 Low-Profile color/mono * $18.95 

* Specify monitor type (i.e. ZVM-135) 



ACCESSORIES 


Microfazer II 128K print buffer 
Backup power supply 400 Watt 
Printer ribbons black/colors 
Computer furniture 
Printer, monitor, etc cables 
Hard disk tape backup (20MB) 
CENTR0NIC Laser Printer 


RETAIL SALE 

$445.00 $349.00 

$699.00 $499.00 

please call/write 
please call/write 
please call/write 
$1,295.00 $895.00 

$2,395.00 $1,895.00 


To order send a check or money order for the 
appropriate amount (no CODs or charges) to 
Kandueazy Computer Software Services (KCSS), 6218 
Blossom Lane, Alexandria, VA 22310. Please add 
$2.50 for shipping and handling. Virginia 
residents add 4% sales tax. FREE CATALOGUE 


SPECIAL: DYSAN DSDD diskettes (bulk pack) only 


$.79 each in any quantity. 
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ZENITH/HEATH 161 


PORTABLE COMPUTER 
ACCESSORIES 


WEATHERPROOF VINYL COVER $29.95 

PROTECT YOUR PORTABLE COMPUTER 
FROM RAIN; SNOW; AND DIRT WITH 
THIS BEAUTIFULLY CUSTOM DESIGNED 
SLIP-OVER COVER CONSTRUCTED OF 
HIGH QUALITY BLACK VINYL . ALSO 
CAN SERVE AS A DUST COVER WHEN 
COMPUTER IS NOT BEING USED . 




PROTECTIVE BACK PANEL $9.95 

ELIMINATE CONCERNS OF DAMAGING 
YOUR COMPUTER CONNECTOR PANEL 
WITH THIS EASY TO INSERT AND 
REMOVE PROTECTIVE BACK PANEL 
CONSTRUCTED OF A TOUGH ACRYLIC 
POLYVINYL MATERIAL. 


SPECIALS $34.95 both vinyl cover and back panel 


pm. PRODUCTS A SERVICES 

453 S McCARRONS BLVD■ROSEVILLE•MN•55113 
(612)-489-0851 


PLEASE SEND CHECK OR M.O. 
(ADD $2.50 FOR SHIPPING) 


□ WEATHERPROOF VINYL COVER - $29.95 □ PROTECTIVE BACK PANEL - $9.95 

□ WEATHERPROOF VINYL COVER AND PROTECTIVE BACK PANEL - $34.95 


NAME_—-- 

ADDRESS ---- 

CITY __ STATE - ZIP 
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introducing 

GRAPH 


POWERFUL PLOTTING 
MADE SIMPLE 


Specifically designed for Engineers, Scientists, and other technical users, 
GRAPH is the plotting and analysis program that allows you endless 
flexibility with a minimum of effort. GRAPH will plot and/or analyze both 
data and equations making it the ultimate TOOL for your simple and 
complex needs. 


GRAPH features include: 

High resolution printer and HP plotter output. Data file input/output. Mul¬ 
tiple curve plotting. Auto scaling. Smoothing. Linear/log axes. Full anno¬ 
tation with GREEK characters. Statistics. Probability density function. 
Extensive math functions including Bessel and numercial intergation. 
Weighting functions (e.g. Taylor, Hamming). Complex variables and data. 
FFT analysis. Power spectral density. Convolution. Random number 
generation.... and much more. 

Requires H/Z100, H/Z150, IBM PC/XT/AT or true compatible, any DOS 
version, minimum 256K RAM, standard color / graphics card. 


Only $99 check, money order, or P.O., plus $4.00 shipping and 
handling. Michigan residents add 4% sales tax. 

To order (specify computer type, memory size, 8087 option) or for more 
information write or call... 


w 


WOLFPAC Technology, Inc. 
P.O. Box 378 

Plymouth, Michigan 48170 
(313) 451-1256 
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Improve Program Quality 
Enhance Program Productivity 

Design your programs around . . . 

ASE, the Aspen Systems Subroutine Editor you can call 
from your programs. With ASE you can easily: 

★ Design you own screen layouts for Program Input 

★ Color and/or highlight input fields 

★ Define your own key functions 

★ Convert and edit a wide variety of fields 

★ Update in several windows simultaneously 

ASE includes 2 major subroutines, many minor subroutines 
and install and demonstration programs. Data & screen 
layouts described in a single map. 

Price $99 Available MSDOS1,2,3 

Demo Disk $5 


ASP, the Aspen Systems Subroutine Package provides 
functions difficult or unavailable in some higher level 
languages, performs those available with greater 
speed/ease or smaller memory requirements. 

The ASP Package includes: 

★ 100 + subroutines 

★ A 300 page manual packed with examples 

★ Test, Demonstration and customization source 

Price $ 1 30 Available MSDOSI ,2,3, CP/M 

All subroutines are callable from assemblers and Microsoft 
Compilers, easily altered for other compilers, can be used 
in EXE or COM programs. 


Prices are PPD (continental USA). 

Colorado Residents add 3% . p q g ox \ 153 

Grand junction, CO 81 502 
SI (303) 245-3262 

/ VISA/MasterCard accepted 

I CP/M and MS-DOS are trademarks of 

\ if l** IP Digital Research and Microsoft, respectively. 
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WINCAD 

For the Z-100 and the Z-150 

The Easy-to-Learn, Fun-to-Use 
Graphics Package Designed for 
Engineers, Architects, Programmers, 
Illustrators & Artists, and Students 


WINCAD allows you to produce: 


• Circuit Designs * Logic Diagrams 

• Floor Plans • Flow Charts 

• Mechanical Designs • Organization Charts 

•Preliminary Architectural Designs 



$ 149.95 

Demonstration disk is available for $10 
plus $2 postage and handling. Please 
write for free brochure. 

Dealer inquiries are invited. 


7 Redwood Dr. 
(406) 494-5610 
Butte, MT 59701 
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obviates the need for a separate assem¬ 
bler. The low-level routine may be put in 
the C source code, set off by directives 
such as #asm and #endasm. For such 
compilers. Listing 3 gives two in-line 
routines to ring the console bell on a 
Z100; the first runs under CP/M and the 
second, under MS-DOS. 

The principles and procedures in both 
versions are the same. First, load a desig¬ 
nated register with the character to be 
displayed. (In this case, the 07 hex 


sounds the bell—or, more accurately on 
Heath/Zenith computers, emits an an¬ 
noying electronic tone.) Next, load an¬ 
other designated register with the operat¬ 
ing system’s “function” number (some¬ 
times known as a “supervisor” or 
“service” number). Then issue the oper¬ 
ating system’s request to perform a func¬ 
tion. In-line assembly language is simple, 
cheap, and effective. 

Nevertheless, I think you surely will 
rue the day you use it. 


The reason is that in-line assembly lan¬ 
guage does in fact make a C program 
almost completely non-portable. Perhaps 
without noticing, you have just seen two 
reasons why. 

For one thing, although some com¬ 
pilers provide for in-line assembly- 
language routines, other compilers do 
not. A program moved from the former 
kind of compiler to the latter will need 
the embedded assembly language re¬ 
moved and replaced with some other way 
to do the job. That is tedious work, espe¬ 
cially when the program is even a little 
complex—sometimes just because it’s 
hard to figure out the code. And it’s im¬ 
possible work if you don’t know enough 
about assembly language and the two 
compilers to figure out how to make the 
change. 

For another thing, the two examples 
from Listing 3 show that even the same 
simple function on the same computer 
must be handled differently under cer¬ 
tain circumstances. 

The H/Z100 is a special microcom¬ 
puter, of course, with dual microproces¬ 
sors capable of being managed by various 
operating systems. Far from being an 
exception, however, it offers a convenient 
illustration of why I think in-line assem¬ 
bly language should be avoided: it 
violates the black box principle and there¬ 
by creates a great deal of trouble in port¬ 
ing a program to a different environment. 

My argument is against in-line assem¬ 
bly language routines, not against assem¬ 
bly language routines themselves. Prop¬ 
erly handled, the use of external 
assembly routines allows one to write a 
sophisticated program without losing 
portability. There, in fact, is one of the 
most attractive features of the C program¬ 
ming language. 

Take, for example, the basic need to 
clear the console screen. “Hard code” 
that machine-dependent function into 
the program—make it part of the pro¬ 
gram itself—and you may find it easier to 
prepare an income tax return than to 
move the program to another environ¬ 
ment. But make the function external to 
the program, and portability becomes 
easy. The only thing hard-coded into the 
program, in our example, is the function 
call: crt_cls( ). Since the function itself is 
external, the C program may be moved 
and recompiled on a different machine 
that has the function available in a library 
prepared for it. When the C program 
reaches the linkage stage, the function is 
pulled into the program to satisfy the call 
and the program works as expected. So an 
external function may be coded one way 
as required by Digital Research’s ASM on 
an 8080 microcomputer running CP/M, 
and another way as required by Micro¬ 
soft s MASM on an 8088 microcomputer 
running PC-DOS or generic MS-DOS. 
All the C program knows is that it has 
asked that the screen be cleared: it is not 


/* ring the bell 

on CP/M */ 

#asm 



MVI 

E,07H 

/* ASCII bell character */ 

MVI 

C ,02H 

/* display character on console */ 

CALL 

05H 

/* call BDOS entry point */ 

#endasm 


/* ring the bell 

on MS-DOS */ 

#asm 



MOV 

DX,07H 

/* ASCII bell character •/ 

MOV 

AH ,02H 

/* display character on console */ 

INT 

21H 

/* function request */ 

#asm 


- 


Listing 3. Two in-line assembly routines which can be inserted directly into C source code. 
Each rings the console bell on a Z100. The top routine runs under CP/M, and the bottom 
one under MS-DOS. 


beep.asm 

lattice.c version 2.10 


PGROUP GROUP PROG 

PROG SEGMENT BYTE PUBLIC ’PROG* 

ASSUME CS:PGROUP 


PUBLIC 

BELL PROC 

PUSH 

MOV 

MOV 

INT 

POP 

RET 

BELL ENDP 

BELL 

NEAR 

BP 

DX,07H 

AH,02H 

21H 

BP 

; for small model 
; save frame pointer 
; character to display 
; display-character function 
; function-request interrupt 
; restore frame pointer 

PROG ENDS 

END 

f 

; end of lattice.c version 


; beep.asm 

; microsoft.c 

version 3.00 


_TEXT SEGMENT PUBLIC 

BYTE f CODE * 

ASSUME 

CS :_TEXT 


PUBLIC 

BELL 


BELL PROC 

NEAR 


PUSH 

BP 


MOV 

DX,07H 

; character to display 

MOV 

AH,02H 

; display-character function 

INT 

21H 

; function-request interrupt 

POP 

BP 


RET 

_BELL ENDP 




JTEXT ENDS 


END 

; end of microsoft.c version 


Listing 4. Two MS-DOS bell-ringing routines for the Z100. Adapted from Listing 3, these 
routines will be used as external assembly language functions. The top version is set up to 
be used with Lattice C, and the bottom one with Microsoft C. 
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concerned about details of how its de¬ 
mand has been satisfied. The program 
therefore uses a machine-dependent 
function without losing portability. 

It works because of the wizard in the C 
compiler: give him a usable name for the 
function, provide him its correct param¬ 
eters, and link him to it. He will follow its 
instructions. 

The tricky part of writing an external 
assembly language function for C is meet¬ 
ing the particular compiler’s require¬ 
ments, otherwise known as its “calling 
conventions,” “entry logic,” “assembly 
language interface,” or something equally 
arcane. An experiment most C program¬ 
mers perform, usually as they’re about 
ready to graduate from the novice class, is 
to try calling a function from a foreign 
library—a library produced for a com¬ 
piler other than the one used for the rest 
of the program. It won’t work. The reason 
is the different calling conventions. 

Unfortunately, this subject—a tricky 
one—is really too large to explore in 
detail here and now. What I can do here 
and now is suggest a direction and offer a 
couple of examples to indicate some of 
what is involved in pursuing that direc¬ 
tion. For those examples and those pur¬ 
poses, our MS-DOS bell-ringing routine 
does nicely. Listing 4 is the same routine 
seen earlier (in Listing 3) as in-line 
assembly language; this time it’s pre¬ 
pared as an external assembly language 
function under MS-DOS—first for Lat¬ 


tice C, version 2.10, and then for Micro¬ 
soft C, version 3.00. Each function is 
intended to be called from a small- 
memory-model program. 

Each of those two examples is a work¬ 
ing function slimmed to the barest essen¬ 
tials required by each compiler, so you 
can focus on their similarities and 
differences. 

At the heart of each function is exactly 
the same routine: make the function 
public so it may be linked; save the BP 
register (the “frame pointer”) on entry as 
a place marker to which we can return 
when the routine has finished; load the 
DX register with a character to “display” 
on the console (the ASCII bell character) 
and the AH register with the number of 
the MS-DOS function for displaying a 
single character; perform the interrupt 
that makes the function request; restore 
the BP register for a return to the C 
program that called the routine; then exit 
by returning. We need to keep track of 
the BP registers because the C compiler, 
which does such housekeeping for inter¬ 
nal functions, has no way to do it for 
external functions. The compiler cannot 
know what will go on in the external 
function: it truly is a black box so far as the 
compiler is concerned. 

The two examples are exactly the same 
wherever the code must only meet the 
requirements of the machine and the 
assemblers. The differences result from 
the two compilers’ individual calling con¬ 


ventions. Minimally, as here, the dif¬ 
ferences include definition of the CS seg¬ 
ment (where code usually goes) conso¬ 
nant with the way the compiler defines it 
when generating .OBJ modules, and the 
orthography by which the compiler 
identifies functions. 

There is no magic involved in creating 
the functions. What I have identified as 
“similar” in these two examples is 
standard MS-DOS usage on the H/Z100, 
H/Z150, and H/Z200 (as well as on other 
PC, XT, and AT compatibles); you can 
look up that usage in various MS-DOS 
programmer’s references. (A particularly 
useful supplement to this work is Peter 
Norton’s Programmers Guide to the IBM 
PC.) For what I have identified as “differ¬ 
ent” in these two examples, however, you 
will have to study your C compiler’s man¬ 
ual: the section on interfacing with as¬ 
sembly language, of course. 

Some compilers make things easier 
than others, with clear and complete ex¬ 
planations and a reasonable number of 
examples: one way or another, Computer 
Innovations C86, Manx Aztec C86, Tool¬ 
works C from The Software Toolworks, 
Ecosoft’s ECO-C88 (version 3), and 
Lattice C (version 2) all do pretty well to 
various degrees. Some other compilers, 
however, do no more than gesture 
towards the necessary: Microsoft C (ver¬ 
sion 3), for example. With those you will 
need patience, ingenuity, and an equable 
disposition. 


REDUCED HOLIDAY PRICES!! 

Direct From The Author* 

HZ100 Simulations 

USS FAST ATTACK™ $ 29.95 


The REAL THING... 

Graphical Simulation 
of Modern Submarine 
Operations and Warfare. 

• Navigation 

• Sonar 

• Trim System 

• Fire Control 

• Much more 

Dl™ $ 29.95 


Faster than Light 
Space Travel Adventure 
with Special 
Animation Effects. 

• Stellar Navigation 

• Defend against attacks 

• Explore distant planets 

• Deploy Robot Lander 

• Much more 

$29.95 

The BEST 2-D Space 
War Arcade Game 
for the HZ100 that 
money can buy! 

(Supports Joy Stick & Sound) 

• Variable space fabric 

• Lay mines 

• Flight practice maze 

• Much more 

REQUIREMENTS 

192K Sys., 32K Color Video, ZDOS/MS-DOS 

Send Check or Money Order to: 

James R. Illman 
P.O. Box 14141 
Seattle, WA 98114 

* (Formerly Interdiscipline Inc.) 
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Need a PAL® 
For Your Z-l 50? 


MegaRAM-150 ™ package allows five 
banks of 256K RAMs to be installed 
on standard memory card for over a 
megabyte of total memory. Resulting 
memory organized as 640K/704K 
main and 512K software controlled 
overlay. Simple installation requires 
no soldering. Includes software 
Device Driver to use overlay memory 
as 512K RAM disk. $49.95 each ppd. 

ZP640 PLUS replacement for U455 
PAL® allows two banks of 256K 
RAMs and two or three banks of 64K 
RAMs to be installed on standard 
memory board for 640K or 704K total 
memory (size selected by J401 
jumper). $24.95 each ppd. 

COM3 package changes COM2 serial 
port to new port address (3E8H) and 
thus allows total of three serial ports. 
COM2 assumed to be on internal 
modem card or similar device. 

Printer driver software included. 
$39.95 ppd. 



FBE Research Company>, Inc. 
P.O. Box 68234 
Seattle, WA 98168 
(206) 246-9815 

PAL® is a trademark of Monolithic Memories Inc. 
VISA and MasterCard Accepted. 
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A 

BRIDGE 

GAMES 

For Your 

Apple, C64/I28, IBM PC/PC Jr., 
Macintosh, and Atari ST 


Tom Throop’s Bridge Baron 

W inner- 1st Computer Bridge Tournament 

Bid and play over 1 million deals, or input your 

own. New features include: 

• Hint feature © Rubber bridge scoring 

• 2-person play • Save deals to disk 

$49.95 ($39.95 for C64; November 

availability for Macintosh and Atari ST) 

Play Bridge with Sheinwold 

Guides you through correct play of 91 challenging 
deals. $29.95 

Play Bridge with Dorothy Hayden Truscott 

Shows you the secrets of winning declarer 
play. $29.95 

5 Weeks to Winning Bridge 

Learn to play bridge from world famous expert 
Alfred Sheinwold. ( November ) $39.95 


At your retailer or send check to: 

T & E associates, Inc. 

PO BOX 362 
Millersville, MD 21108 
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Assemblers for C functions 

It’s easier to get your feet wet 
writing assembly language functions 
under CP/M than under MS-DOS. That’s 
true in part because the Z80 and 8085 
microprocessors (on which CP/M runs) 
don’t have segmented memory. Keeping 
track of memory segments is at least a 
nuisance on the 8085’s more powerful 
siblings, and—when working with any¬ 
thing but the small-memory model—is 
potentially the cause of real trouble. 
Fortunately, even sophisticated C 
programs can be written within the MS- 
DOS small-memory model, which ad¬ 
dresses only the machine’s first available 
memory segment—thereby removing 
from the programmer much need for 
further consideration of segmentation. 
(The MS-DOS versions of WordStar and 
dBASE II do pretty well as examples of 
what can be done with small-memory- 
model programs.) 

In any case, I’ll mention once again, 
you need tools: an assembler, a linker, 
and most likely a librarian, all of which 
must work together. (Be careful about 
trying to mix and match tools from differ¬ 
ent companies, or different “lines” of tools 
from the same company, or even different 
versions of tools in the same line from the 
same company.) Some programmers disa¬ 
gree, but I think that the choice of assem¬ 
bler should come first, because the rest of 
the toolkit either comes with it or must be 
chosen to match it. 


On an 8-bit machine, such as an H89 or 
a Z100 running CP/M, Digital Research’s 
bottom-of-the-line assembler, ASM, is all a 
C programmer might ever need. It is 
supplied with the operating system itself, 
on the distribution disks, so there is little 
reason many programmers will need to 
spend money or time on a decision about 
which assembler to use. 

For a considerable step up, there’s 
Digital Research’s MAC (no longer 
produced, I understand), Microsoft’s M- 
80 (in its macro assembler package), 
or—on Heath/Zenith’s CP/M microcom¬ 
puters with a Z80 microprocessor—SLR 
Systems’ Z80ASM . My advice is to become 
familiar with Digital Research’s ASM 
before going on to these more powerful 
tools. It’s not so much the principle that 
you’ll see things more clearly after you 
stop banging your head against the wall; 
it’s more a combination of the principle 
that one shouldn’t buy a cow when milk is 
cheap and the judgment that complex 
tools are an unnecessary complication for 
a beginner. If the modest cost is not a real 
concern, if you’re at the stage to appreci¬ 
ate fine tools, and if you own a microcom¬ 
puter with a Z80, you should enjoy 
Z80ASM. (It’s available separately from 
SLR Systems or from Ecosoft as part of a 
package with the Eco-C C compiler.) 

As always, things get tangled when you 
move to a 16-bit machine and MS-DOS. 

If you have Z-DOS, version 1 of MS- 
DOS for the H/Z100, you also have ver¬ 


sion 1.07 of MASM, Microsoft’s macro 
assembler. Buggy, limited, and now su¬ 
perseded for writing full-length pro¬ 
grams, Macro-86 (as it is called in the 
Z-DOS manuals) still can be perfectly 
acceptable for the relatively short 
functions normally added to C, if neither 
you nor your requirements get too fancy. 
It may be used to process code for all 
versions of MS-DOS no matter what the 
microcomputer—the TOO, T50, or ’200. 

Of course, because it is an early version 
of MASM, Macro-86 supports only the 
8086 instruction set. It therefore will not 
address the 8087 numeric coprocessor 
one can put into Heath/Zenith 8088 and 
8088-2 microcomputers (such as the TOO, 
150, and T58). Nor will it allow the spe¬ 
cial instructions for the 80286 or its 80287 
numeric coprocessor (on the ’200 series). 
So mavens will require a fresher, and 
therefore more robust, assembler than 
Macro-86. 

The obvious choices, in chronological 
order, are all by Microsoft—no matter 
whose label appears on the package. 
(chasm— a proposed alternative to Micro¬ 
soft’s assembler available as freeware or 
shareware on bulletin boards and from 
user’s groups—isn’t suitable for writing C 
functions because it does not produce 
linkable object code, the requisite inter¬ 
mediate between source file and ex¬ 
ecutable program.) 

MASM version 1.27 (dated 12/09/83) is 
included in the MS-DOS Version 2 Pro¬ 
grammer’s Utility Pack sold by Heath. 
Nothing in the package I own seems cur¬ 
rent by any way I know to measure time, 
but the sheer bulk of stuff in the package 
(including the documentation and disks 
of utilities and mostly outdated source 
code) gives the Programmer’s Utility 
Pack some value to the advanced C 
programmer. Even this early version of 
the assembler is useful in producing 
functions for a library not required to take 
advantage of anything but the basic 8088 
microprocessor. 

Next in time is the IBM Macro Assem¬ 
bler, version 2.00 of MASM (dated 07/18/ 
84). Although it too is not current, it is a 
major step up from the two Heath/Zenith 
packages. With that revision came sup¬ 
port of the 8087, 80286, and 80287 (the 
numeric coprocessor for the 80286). One 
can use this MASM to get more out of a 
souped-up 150 or ’200 than is possible 
with the earlier releases. 

In addition, the IBM package has 
unique value for someone learning as¬ 
sembler. The documentation—two vol¬ 
umes—is first rate. They are not primers, 
but the assembler manual and its accom¬ 
panying reference manual do represent 
the next big learning step up from a 
primer. They provide insights and ex¬ 
planations as well as instructions for the 
tools. Best of all, the package offers some 
cookbook features in the form of disk- 
based recipes. These are skeletons similar 
to the one I supplied for C filters in a 


ENJOY YOUR CP/M COMPUTER AGAIN 

CompulV/lagic ’s put 20 programs into one super 
CP/M Utility Package. No fancy menus; No flashy 
graphics; Just flexible, fast, hard working programs that 
do what you want them to do. 

Utility programs aren’t sexy, but these programs have 
a way of making even dull tasks like file copying, re¬ 
naming, sorting, and even erasing so much easier that 
it’s almost exciting. Directory listings, turnkey program 
starters, screen capture and more. The programs are 
described in detail in the more than 50 pages of 
documentation. Order it now and start enjoying your 
CP/M computer again. Only $45. 

30-DAY MONEY-BACK GUARANTEE. All CompuMagic products are fully func¬ 
tional and fully supported, and come with a full, 30-day, money-back guarantee. 

ORDER NOW: Send Check or MO (Personal checks accepted) or call with your 
MC, Visa, or COD order. NO charge for UPS ground shipping. Add $2 for UPS COD 
and $5 for foreign orders. (MD Res. add 5% tax.) Available in 5" Hard Sector and 
5" and 8" Soft Sector Formats. Be sure to specify what you need. 

CompuMagic, Inc.” 

P.O. Box 437 
Severn, MD 21144 
(301) 969-8068 
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Disks $Q 



Hard or Soft Sector, Double Sided, 
Double Density; Hub Rings, Write tabs, 
Rainbow labels. 

HARD SECTOR Single sided, Double 
Density. $ 8.00 for ten. 

QDC 

Quick Disk Copy utility for Z-150 and 
PC's. Reads your source disk into 
memory once, then formats, writes, and 
verifies destination disks. Allows you 
to make multiple -copies of the same 
source without re-reading the disk. 
$ 25.00 postpaid. 

Z-UTIL 

For Z-100. Includes SCREEN, dump for 
most popular dot-matrix printers, 
RUNPC, PC emulator program, and TP, 
Computer- typewriter program for memos, 
etc. $ 35.00 ppd. 


User Programmable Character drivers for 
H/Z-8/89/90. For HD0S or Heath CPM 
(specify) with Epson, MPI, C.Itoh/NEC 
8023, Microline printer (specify). 
Prints H/Z graphics, and inverse, on 
your printer. Accepts input from 
Software Toolworks' Ed-A-Sketch. 
$ 25.00 ppd. 

Ribbons 

Ribbon Refills w/ Gloves 

#7201 Epson MX/FX/RX,MPI $ 3.00 

#72011 As above, RED $ 3.50 

#72012 As above, GREEN $ 3.50 
#7202 NEC-8023,CItoh 8510 $ 2.50 
Cartridges 

#7203 Epson MX/FX/RX-80 $ 6.00 

#7206 Epson MX/FX/RX-100 $ 8.50 

#7204 NEC-8023,CItoh 8510 $ 5.00 
#7207 Diablo Multistrike $ 3.75 

Ribbon Spools 

#7205 Star SG/Gemini/Oki $ 2.50 

Please add $2.00 to your ribbon or disk 
order for shipping and handling. 

LINDLEY SYSTEMS 21 Hancock St. 

Bedford, MA 01730 (617) 275-6821 
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Coming Up In Sextant 

Results of the Fractal Image Contest (announced in 
Sextant #23, July-August 1986) 

What you get from the Programmer s Utility Pack 
(version 3) for your Z100/Z150 computer 
A look at how you can turn your computer into a 
dumb terminal—under either CP/M or MS-DOS 
Upgrading the ’39 


Quality 
'89 

Enhancements 

Still 

Available. 



MOVING? 

Don't lose your 
next issue of 
Sextant in the 
shuffle. 

Send your change 
of address to: 

Sextant 

Attn: Circulation 
Department 
716 E Street, S.E. 
Washington, DC 
20003 


MAGNOLIA H 

MICROSYSTEMS 

2820 Thorndyke Avenue West 
Seattle, WA 98199 
(206) 285-7266 
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Q Scientific Library 


CSL S245 


ADVANCED MATRIX COMPUTATION and DECOMPOSITION 
EIGENSYSTEMS and SINGULAR VALUE ANALYSIS 
MATRIX INVERSIONS, MULTIPLEXING, and LINEAR ALGEBRA 
DIFFERERENTIAL EQUATIONS OF ANY ORDER 
MULTI-DIMENSION QUADRATURE 
COMPLEX VARIABLES and POLYNOMIALS 
INTERPOLATION and MULTI-DIM TABLE LOOK-UP 
STATISTICS, PROBABILITY and ANALYSIS OF VARIANCE 
LEAST SQUARES and REGRESSION 
TIME SERIES and DATA ANALYSIS 
DISCRETE and FAST FOURIER TRANSFORMS 
NONLINEAR EQUATIONS and MULTI-DIM OPTIMIZATION 
FINANCE and CALENDAR FUNCTIONS 
SPECIAL MATH FUNCTIONS, FITTING and EVALUATION 
UTILITIES and GRAPHICS (for Z100 and IBM/PC/XT) 

"Most sophisticated C scientific library available for PC’s." 

■Your CSL library is great. ...best software purchase I made since buying my Z100." 

Over 300 functions. 556 page Manual with tutorial and examples. Available for either 
Microsoft or Computer Innovations C compilers. Requires either Z100 or IBM PC 
compatible, 8087 coprocessor, and MS(PC)DOS. 25% discount on CSL when ordered 
with the C86 compiler. 


COMPILERS: Computer Innovations C Compiler $298 

The Software Toolworks C and MATHPAK Combo $75 


■ EIGENWARE TECHNOLOGIES 

13090 La Vista Drive 
Saratoga, CA 95070 
(408) 867-1184 

....immmiiii 
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previous column, but they are for 
assembly language programs: for a COM 
program and for MS-DOS 1 and 2 EXE 
programs. In the package also is SALUT, 
IBM’s “Structured Assembly Language 
Utilities,” which helps develop a struc¬ 
tured approach—the right approach for a 
C programmer—to assembler. 

The current version of MASM is version 
4.0 (dated 10/16/85), available directly 
from Microsoft in its Macro Assembler 
package. Its documentation seems in sev¬ 
eral ways an improvement over earlier 
versions I have seen—more useful ex¬ 
planations, for one thing, and closer in 
some respects to the words in IBM’s 
books. 

There also are useful utilities, such as 
MAKE, EXEPACK, and SYMDEB in the ver¬ 
sion 4 package. 

We looked at one Make—not Micro¬ 
soft’s but Seidl Computer Engineering’s 
SMK —in the July-August “C Notes.” The 
genus Make is a tool, descended from a 
Unix utility of the same name, designed 
to keep track of program modules that do 
or do not need reprocessing when part of 
the program is changed. Microsoft’s is 
more like the standard Unix program and 
therefore much less friendly than Seidl’s. 
The ten-page section of the assembler 
manual intended to explain its use is 
simply not in the same league as Seidl’s 
exhaustive documentation. But, then, 
Seidl’s SMK costs—and Microsoft’s MAKE 


is a throw-in. 

EXEPACK is a tool for shrinking big EXE 
files by internally compressing duplicate 
code. Sometimes, though, and especially 
with relatively small program files, it ac¬ 
tually makes program size increase. For¬ 
tunately, EXEPACK does not overwrite the 
original. I’ve therefore taken to running 
the utility over all my Microsoft C EXE 
programs: if they shrink, I keep the new 
versions; if they bulge, I stay with the 
original. (I also try shrinking commercial 
programs with EXEPACK: some slim down 
nicely by a few kilobytes.) It’s a little like 
being in Wonderland: I’m sure there 
must be a way to tell in advance which 
will happen, but I don’t know yet. Never¬ 
theless, I value EXEPACK. 

SYMDEB is a symbolic debugger, a big 
advance over DEBUG (the debugging tool 
supplied with MS-DOS), and very useful 
indeed. But there are some super debug¬ 
ging tools available, far more powerful 
than SYMDEB, and we’ll look at two in a 
moment. 

One change in MASM version 4.0 of 
special interest to C programmers is that 
it no longer supports the octal radix. If 
you have labored long and hard to learn 
counting with eight fingers instead of ten 
or sixteen, take my sympathy. Although 
the current version of Microsoft C—ver¬ 
sion 3.0—continues to support octal, my 
hunch is that Microsoft will jettison octal 
for good, or at least for now. 


Advanced assembly language 
debuggers 

I’ve had some experience with two 
sophisticated debuggers for assembly lan¬ 
guage: Morgan Computing’s Advanced 
Trace86 (AT86) and SoftAdvances’ DSD86. 
Both are serious products, not gimmicks, 
and either is well worth having if assem¬ 
bly language comes to play a significant 
role in your programming. Both are more 
sophisticated than Microsoft’s SYMDEB, 
which itself makes DEBUG look like a 
country cousin. 

AT86 is the all-around simpler pro¬ 
gram—simpler in functionality and 
simpler to operate. The documentation is 
reasonably good, and there is reasonably 
good on-line help. The help also includes 
demonstration routines that exercise the 
debugger’s major features while one 
watches. They are useful the first few 
times around, but I soon grew tired of the 
message that calls attention to their exis¬ 
tence whenever AT86 is run. 

AT86.EXE, with its AT86.HLP file, is use¬ 
ful as a general assembly language debug¬ 
ger that can be used to debug routines for 
any C package that uses MASM output. 
Taking about 92K together, they occupy 
little space for an all-in-one interpreter/ 
compiler/disassembler. Feed our bell¬ 
ringing function to AT86 in its assembler 
mode, then switch to its trace mode and 
watch the function in action. It’s easy to 
set breakpoints—conditions at which ex¬ 
ecution stops—as a way to catch what’s 
going on just before a hot spot. 

Because AT86 is so small a program, and 
because the system needs no preparation 
for its use, AT86 is especially good as a 
learning device, or as a debugger when 
writing functions for C. Unfortunately, it 
cannot handle an EXE file, so you can’t use 
AT86 to debug most complete C pro¬ 
grams—unless you have a compiler that 
can produce COM programs. 

DSD86 can debug the EXE programs 
most MS-DOS C compilers produce. In 
fact, included on the distribution disk as a 
guinea pig for dissection with DSD86 is LS, 
a directory program in C derived from 
the Unix utility, in the .ASM, .OBJ, and 
.EXE stages needed for source-level de¬ 
bugging of the finished program. (The 
dialect is Computer Innovations’ C86, 
but you don’t need that compiler—or any 
compiler—to work the debugger on the 
sample program.) DSD86 is an extremely 
powerful debugger, useful not only with 
C and assembly language but also with 
other languages. 

DSD86 is a serious professional tool. 
Because of SoftAdvances’ belief that there 
is no anticipating individual tastes, DSD86 
is almost infinitely configurable. It has 
splendid macro capabilities that allow 
binding commands to keys as you want 
them, so your copy of DSD86 may work 
entirely differently from mine when we 
get finished setting them up. It also 
allows you to customize a set of overlap- 


VAX/PC Users 


ZSTEMpc™-VT220 Emulator for the PC Series 

High performance COLOR VT220. Double high/ 
wide, 132 mode, smooth scrolling, downloadable 
fonts, user defined keys, 8-bit and full national/ 
multinational modes, XMODEM and KERMIT, 
softkey/MACROS, DOS access $150.00 

Also available VT220 Style replacement keyboard. 

ZSTEMpc™-VT 100 Emulator for the PC Series 

High Performance COLOR VT100 $99.00 

ZSTEMpc™-4014 Emulator for the PC Series 

Use with ZSTEMpc-VTIOO, VT220, or stand 
alone. Interactive zoom and plan. Save/recall 
images to/from disk. Keypad, mouse, printer, 
and plotter support. 

ZSTEM™-VT 100 Emulator for Z-100s $148.95 
DECkHAND™ Utilities for the Z-100 & PC Series 

MS-DOS Utilities with VAX/PDP-11 switch pro¬ 
cessing, DIR, COPY, DELETE, RENAME, TYPE 
with wildcards, full DATE processing, attribute 
processing, query, backup and more. $ 49.00 


Z-100 PC Memory 
Expansion with ZPAL™ 

Z-151/Z-161 Users 

Use 256K bit memory chips on the 
original memory board. Extend the 
memory to 640K or 704K bytes with 
ZPAL-2 Decoder $ 38.00 

Z-158 Users 

Extend your system to 768K bytes 
with 3 banks of 256K bit memory 
chips and ZPAL-158 decoder. 

704K contiguous + 64K separate 
or 

640K contiguous + 128K separate 

ZPAL-158 Decoder _ $ 36.00 

Z-138/Z-148 Users 
Extend your system to 768K bytes 
with 3 banks of 256K bit memory 
chips and ZPAL-148 decoder. 

704K contiguous + 64K separate 
or 

640K contiguous + 128K separate 
ZPAL-148 Decoder $ 36.00 


^ZSTEMpc-VTIOOC 
Choice of the 
U.S. Airforce 
5,000-10,000 
; ZSTEMpc-VTIOO 
Packages 
AFCAC 254 



Call today: VISA and MasterCard accepted 
Quantity and dealer discounts available 
30 day money back guarantee 
AIR MAIL POSTAGE included for US & Canada 
KEA Systems Ltd. 

2150 West Broadway, Suite 412 
Vancouver, B. C. CANADA V6K 4L9 
Technical Support (604) 732-7411 
TELEX 04-352848 VCR 
Order desk (800) 663-8702 Toll Free 

Trademarks IBM PC.jr.XT.AT - IBM Corporation. VT100, VT220, DEC, VAX - Digital Equipment Corp. ZSTEMpc - KEA Systems Ltd. 


Zstem 

7, KEA 



Circle #175 on Reader Service Card 


72 Sextant November-December 1986 






Z-100 AND Z-150 PRODUCTS FROM 
Computer Graphics Center, Inc. 

ADD A NEW 
DIMENSION 
TO YOUR H/Z-100 

Z3D is a highly versatile, user friendly program for 
making and displaying three dimensional objects. If 
you are an artist, architect, engineer or scientist — or 
have any other interest in graphics — you need Z3D. 

Applications of Z3D range from modelling entire 
towns to demonstrating molecular structures. You are 
limited only by your imagination and the size of your 
H/Z-100 memory. Features of Z3D include: 

• Making objects or scenes in either monochrome 
or color (up to 36 hues). 

• Automatic rotation and scale changes when an 
eyepoint position is selected. 

• Automatic shading when a light source position 
is selected. 

• Hidden line removal option. 

An illustrated tutorial manual accompanies the pro¬ 
gram. Only 192k of memory is required and the 8087 
coprocessor is optionally supported. Z3D is truly a 
bargain at its $125.00 price. Send for your copy today 
Please specify your operating system. 

Circle Reader Service No. 139 for information on Z3D 

Computer Graphics Center, Inc. 

Mastercard 140 UNIVERSITY AVE., SUITE 65 SHOWROOM 
and Visa PALO ALTO, CA 94301 444 High St. 

Accepted PHONE: 415-325-3111 Palo Alto, CA 

California add 6.5% tax. except Santa Clara County add 7.0%. 
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HOME 
FINANCE SYSTEM 
VERSION 2 

—An extensive Home Finance System that 
keeps track of checking, asset accounts 
(cash, savings, IRAs, CDs), and regular bill 
payments. Let your printer write your 
checks for you on any business-sized check 
(design your own check format). 

—Checks have user defined codes and a 
separate flag for tax deductible items. 

—Many reports, including listing all checks, 
or checks by codes or tax flag. 

—System consists of 130 page users manual 
with 5 program disks (5-V4") and a sample 
data disk. 

Hardware: H8/HZ89 (64K) or HZ100 with 2 disk drives. Any 
Heath®, Zenith® or other printer. 

Software: CP/M or CP/M-85/86 (Ver. 2.2) and MBASIC 5.21 for 
CP/M. 

Order: Complete System $89+ (specify hard or soft sector 574", 
HZ89 or HZ100). Manual alone $21.+ 

MasterCard/Visa accepted, please include your phone number. 

+Prices include shipping. 


Jay H. Gold, M.D. 

Jay Gold Software 
Box 2024, Des Moines, IA 50310 
(515) 279-9821 
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S & K Technology, Inc. 

Quality Software for Heath/Zenith Microcomputers 


For the Z100... 

Watchword® $100.00 

The ultimate in word processing with speed and power. 
See subscripts, superscripts, underlining, and boldface 
directly on the screen. Create your own fonts and special 
characters. Other features include centering, formatting, 
automatic horizontal scrolling with long lines, large file 
capability, split screen, macros, color, and an extensive 
configuration facility. See reviews in Remark (July 1985) 
and Sextant (Jan-Feb 1985, Sep-Oct 1985). Requires 
192K RAM. 


The Resident Speller™ 

Spelling checker for use with Watchword. 
Checks as you type from inside Watchword or 
checks a file. 

Includes a 50,000 word expandable dictionary. 
Requires 192K RAM to check a file. 

Requires 300K RAM to check as you type. 

Demo disk for both 


$100.00 


$ 3.00 


For IBM compatibles including the 
Z150 and Z200 series... 


PC watchword® (New) 


$ 99.95 


The ultimate in word processing for the sophisticated 
user. Most of the features of the Z100 version except for 
screen fonts. Requires 256K RAM. 

PC Resident Speller™ $ 99.95 

Spelling checker for ASCII files such as those created 
with Watchword, WordStar, WordPerfect, PeachText, and 
VolksWriter. Includes Strike. Requires 256K RAM. 

Strike™ $ 49.95 

Adds as-you-type spelling checking to your word pro¬ 
cessor. Works with the word processors above and also 
with DisplayWrite, MultiMate and PFS.Write. Requires 
100K RAM in addition to that used by your word 
processor. % 


Demo disk for Strike and 
The PC Resident Speller 

Demo disk for PC WatchWord 


$ 

$ 


2.00 

2.00 


Texas residents please add state sales tax. 


S&K Technology, Inc., 4610 Spotted Oak Woods, San Antonio, Texas 78249, (512) 492-3384^ 
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Listing 5. ASNICE.C is a simple formatter which converts an assembler routines code 
sections to uppercase, and comment sections to lowercase. 


/• 

** ASNICE.C — formatter for assembly-language source code 

H 

ft 1.00, 11 Apr 86, Joseph Katz 

•/ 


^include <stdio.h> 


/* compiler dependent */ 


/* input bytes •/ 

/* to check dup filenames */ 


/• uppercase string for dup check •/ 


//define PROGRAM "ASNICE" 

^define VERSION ”1.00" 

^define PURPOSE "Assembler source code beautifier" 

#ifdef SKIMPY /« if skimpy stdio.h «/ 

^define EOF -1 
#define NULL 0 
#endif 

int c; 

int inname, outname; 
int flag; 

FILE *input, *output, *fopen(); 

upper(s) 
char *s; 

{ 

char # p; 

for(p = s; *p; ++p) 

*p = toupper(*p); 
return(s); 

} /• end upper() */ 

main(argc,argv) 
int argc; 
char *argv[]; 

{ 

banner(); 

/* progressive error trapping section */ 

/• check for correct number of arguments */ 
if(argc != 3) ( 

printf("Specify input and output filenames\n"); 
exit(1); /• error exit •/ 

} 

/* check for same name used as input and output •/ 
inname = upper(argv[1]); /• uppercase input name •/ 

outname = upper(argv[2]); /• uppercase output name •/ 

if(strcmp(inname, outname) == NULL) { /• NULL if the same */ 
printf("Make input and output names different\n"); 
exit(1); /* error exit */ 

} 


/* accept command-line args */ 
/* count args •/ 

/• array of ptrs to args */ 


ping windows to suit your needs and 
preferences, so your copy may even look 
different from mine. And beyond the 
powerful user interface is an even more 
powerful set of capabilities for the debug¬ 
ging itself. 

Such power brings responsibilities. 
Unfortunately, SoftAdvances shifts these 
almost entirely to the user, who must be 
prepared for long sessions with the man¬ 
ual, debugger, and sample files. You will 
even be called upon to create your own 
sample files (like HELLQEXE). You must, 
for example, configure the debugger the 
way you want it to work—even the first 
time you try using it, even before you 
know how. I found it a frustrating, tedious 
job. Good as the documentation is once 
one has some familiarity with the debug¬ 
ger, it is not good enough for the casual, 
infrequent, or first-time user. I may be 
carping: I think not. 

I like DSD86, and I think it could be a 
tiger were it only packaged better. I don’t 
mean a pretty wrapper. I mean things 
like a manual instead of mere documenta¬ 
tion—a text that relieves the new user of 
having to wrestle with the tool before it 
can be used to do what is wanted—and 
defaults for everything that now has to be 
set up individually. Maybe SoftAdvances 
has come to see the need for providing 
more help in taming its potential tiger: a 
recent letter from John Otken, the com¬ 
pany’s president, announces a new ver¬ 
sion that seems to promise what I think is 
needed. Be sure I’ll let you know. Even 
now, though, the tool itself— DSD86 —is 
superb for real debugging of C programs 
if one is motivated to hack through 
using it. 

Two things more. One, which SoftAd¬ 
vances points out in a disk file addendum 
to the documentation, is something a C 
programmer really needs to know before 
buying: source-level debugging—adding 
a window onto the source code while 
working with the object code—in DSD86 
requires version 3.00 or higher of Micro¬ 
soft’s linker, LINK.EXE. The only way to 
get it that I know so far is with version 4.0 
of Microsoft’s Macro Assembler. 

The second thing is that John Otken 
evidently is committed to this product: I 
have received more letters from him—all 
unsolicited, but relevant, sane, and 
helpful—about DSD86 than I have re¬ 
ceived from any other vendor about any¬ 
thing during my decades as a reviewer. It 
is a pretty impressive performance in 
an industry I find remarkably maladroit 
about such things. The result is that I 
really believe you will have no trouble 
getting support or satisfaction from 
SoftAdvances. 

Nevertheless, don’t delude yourself, or 
let yourself be deluded, into thinking that 
any available debugger will fix a broken or 
maladroit program for you. Debuggers 
are tools that require knowledge and 
skill. Just as ownership of cabinetmakers’ 
screwdrivers does not confer cabinetmak¬ 


er status on a handyman, neither does the 
mere purchase of a debugger guarantee 
professional programs. 

ASNICE.C: a simple formatter for 
assembly language functions 

Fortunately, it’s easy to make the 
code for assembly language functions at 
least look professional. An example is 
ASNICE.C, a program I’ve written and of¬ 
fer to you here. 

Each to his own taste, as someone said 
earlier, but one convention in formatting 
assembler code is for the code sections 
themselves to be entirely in uppercase 
and the comments to be entirely in lower¬ 
case. Assemblers like MASM do not care 
about case, but the convention makes 
things easier for programmers who have 
to revise their own code. I’m for anything 
that removes or at least reduces life’s little 
nuisances. 

That principle shines through the 
source code for ASNICE.C. (See Listing 5.) 


If most of it looks familiar, that’s right. 
The heart of ASNICE.C —the I/O (input/ 
output) functions—is the filter structure 
we’ve seen previously in this column. I 
said we would be reusing it in various 
tools from time to time, and now is one of 
those times. 

The function that does the actual 
formatting simply reads input from the 
original source code, blithely uppercas¬ 
ing all lowercase alphabetical unless and 
until it encounters a semicolon. The 
semicolon is the default separator be¬ 
tween comments and code in assembler: 
everything to the left of one on a line is 
treated as code; everything to the right of 
one on a line is treated as comment. 
When a semicolon appears, the function 
just as blithely starts lowercasing all 
uppercase alphabetical until it hits a 
newline (what C understands as the end 
of a line). Then it switches back to upper¬ 
casing. And so it goes until the input file is 
exhausted. 
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/• check for existing file with same name as output */ 
if(fopen(argv[2],"r n ) != NULL) { 

printf("Overwrite existing file with same name as output (Y/N)? "); 

if(toupper(getchar()) != *Y 1 ) { /• ’Y’ or ’y’ only •/ 

printf("Aborted by user\n"); 
exit(1); /* error exit •/ 

} 

} 

/• open input if it exists */ 
input=fopen(argv[1] ,"r"); /* open input */ 

if(input==NULL) { /• no such file •/ 

printf("Can’t find the input file\n"); 
exit(1); /* error exit •/ 

} 

/* open output and check for full disk or directory */ 
output=fopen(argv[2],"w"); /• open output */ 
if(output==NULL) { /• disk or directory full */ 

printf("Can’t make the output file\n"); 
fclose(input); /* guarantees the close •/ 

exit(1); /» error exit */ 

} 

/• flow control and transformation section */ 

while((c=getc(input))J=EOF) { /* flow control •/ 

if( c== ’;* ) flag s 1; /• set when a semicolon */ 

if( c == ’\n’) flag = 0; /• reset when a newline •/ 

if(flag == 0) { /• not in a comment */ 

c = toupper(c); /• uppercase it */ 
putc(c,output); /* write to output */ 

} 

else { /* in a comment */ 

c = tolower(c); /* lowercase it */ 
putc(c,output); /• write to output */ 

} 

/* display on console to show we’re alive •/ 
putchar(c); 

} 

/* termination section •/ 

fclose(input); /• close files •/ 

fclose(output); 

exit(0); /* normal exit •/ 

} /• end main() •/ 

banner() 

{ 

printf("*s — %s ($s)\n",PROGRAM, PURPOSE, VERSION); 
printf("Copyright (C), 1986, by Joseph Katz\n"); 

} /» end banner() */ 


But take care. ASNICE is not one of your 
intellectual giants: the transformation 
function is mindless, so when you need 
lowercase in a code statement you have 
one of three options. First, do not use 
ASNICE to format that source code. I don’t 
like that option because then I am embar¬ 
rassed to show you my functions. Second, 
format the source code with ASNICE and 
then edit it with a word processor to 
restore the essential lowercase charac¬ 
ters. That’s my present practice because, 
as a representative of the essentially lazy 
segment of humanity, I feel controlled by 
fate. The third choice is the one I really 
urge: you rewrite the transformation 
function and send me a copy of your 
source code and executable program on 
an MS-DOS disk. 

An assembly language bookshelf 
for C programmers 

That’s way too grand a title, but at least 
it is suggestive of a point I have been 


trying to make: the C programmer can 
draw on assembly language for functions, 
not as an end in itself. Your requirements 
are much less stringent than those of 
someone who wants to do programs en¬ 
tirely in assembly language. 

If my suggested orientation is clear, you 
won’t be surprised to find me saying that 
I haven’t found a useless book on Z80, 
8080, or 8088 assembly language. Some 
of them might disappoint a sharp, dedi¬ 
cated assembly language programmer; 
and to me, at least, some offer pretty 
fuzzy exposition. All the books I’ve seen 
have examples that can be transformed 
into C functions for solving particular 
problems and for suggesting new direc¬ 
tions. These may help once one has a 
grasp of how to program on the machine’s 
level and knows a C compiler’s assembly 
language interface. So I can’t in good 
conscience attempt something like the 
Harvard Classics everyone must read. 

If you are new to assembly language 


programming, your interest in Heath/ 
Zenith computers puts you in the best 
possible place to learn it. The Heath 
Educational Systems courses—EC-1108 
on the 8080/8085 for the 8-bit machines, 
and EC-1201 (Introducing Macro-86) and 
EC-1202 (Macro-86 Programming Algo¬ 
rithms)—are the best self-paced courses I 
know, and you have the right equipment 
to take best advantage of them. We tend 
to overlook “the best” when it grows in 
our own backyard. Don’t. Start with 
these courses. By the way, that’s my 
advice to owners of other equipment as 
well. 

CP/M users might be well advised to 
go from the 8080/8085 course to Waite 
and Lafore’s Soul of CP/M. Its approach is 
a gimmick, really—the book is based on 
the premise that one can become an 
assembly language programmer knowing 
little more than how to use the CP/M 
system calls. But that’s exactly the right 
approach for a C programmer starting out 
developing assembly language functions, 
so this book is a “must.” 

The next steps up are David E. 
Cortesi’s Inside CP/M and his A 
Programmers Notebook: Utilities for 
CP/M-80. Each book is an advance in the 
chain of complexity that starts with the 
Heath course, and both books have good 
examples and nice tricks. 

If you have an 8" disk drive on your 
CP/M machine, you might want to get the 
diskette for A Programmers Notebook as 
well as the book: it will save you some 
fussy typing. All these books, incidental¬ 
ly, are models of good, clear, instructional 
writing. 

I see no equally clear path forward 
from the two Heath courses on Macro-86. 
By all means, do the introductory 
course before the programming algo¬ 
rithms course; but if you take recess 
between the two, even at that stage you 
ought to be able to write a good many C 
functions. So you might want to begin 
building your bookshelf right away. 

Peter Norton’s Programmers Guide to 
the IBM PC should be the book you put 
on it as soon as possible: it makes sense 
out of the things mumbled hazily in the 
technical manuals for the IBM PC, XT, 
and AT, and the H/Z100, 150, and ’200. 
With Norton’s book you don’t need the 
IBM manuals. Since they are mentioned 
almost everywhere, you might be tempt¬ 
ed to buy them anyway. When those fits 
start, call the most parsimonious friend 
you have, read this paragraph to him, and 
listen to his advice. 

If you choose to ignore it, at least you 
should not buy more than one in the 
series: the differences among them are 
not enough to justify the expense for 
someone with Heath/Zenith equipment. 
You might be better off spending that 
money on Zenith’s MS-DOS Version 2 
Programmer’s Utility Pack and Program¬ 
mer’s Reference Manual for the Z150— 
but I don’t think even these are essential 
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OKIDUMP ** EPSDUMP 

OKIDUMP will dump your Z-100/120 
screen to any OKIDATA Microline 
Series printer. OKIDUMP will do 
a graphics or inverse graphics 
dump, or a text only dump. 

EPSDUMP does the same functions 
for the EPSON MX-80 Series 
printer (w/graphics capability). 

OKI92 will send printer escape 
codes to the OKIDATA Microline 
Series printer. Set margins, 
tabs, character widths, etc. 

COLOR will set the foreground/ 
background color on your monitor. 

Special prices until 31 Dec 1986 
OKIDUMP - EPSDUMP - OKI92 
$18.95 each, includes COLOR FREE 
or COLOR $9.95 

C & H Consultants 
204 Alexander Drive 
Warner Robins, GA 31093 
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Super Chip Set 

•4 Chip Set 
•12 New Features 
•256 Characters 
• Double Strike 
•Super/Sub’s 
•Underline 

•Italics rtrt 

•more $84.95 

+S&H 

FINA SOFTWARE 

1 61 44 Sunset Bl. #3 
Pacific Palisades 
California 90272 

213/454-6393 
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EXAM BUILDER 

The Most Comprehensive Exam Storage 
and Generation System on the Market- 
In Use In Over 200 Major Universities 

• Multiple User-Chosen Subjects 

• Complete Question Entry/Edit 
Capability 

• Random or teacher-selected items 
for finished exam 

• Single or Multi-Subject Exams 

• Printed copy is ready for 
reproduction 

• Master list print capability 

• Password protected answer keys 

• Zenith, Apple, TRS-80, IBM 
School Purchase Orders Accepted 

No Time Limit Guarantee 
$99.95 

(316) 682-0156 

A.U. SOFTWARE—DEPT. ST 
P.O. Box 8369 
Wichita, KS 67208 


for your purposes right now. 

You might be better off picking through 
books on 8088/8086 assembly language at 
your local bookstore, looking for specific 
functions. Morgan’s Bluebook of Assem¬ 
bly Routines for the IBM PC and XT and 
Jourdain’s Programmers Problem Solver 
for the IBM PC, XT, and AT are both 
useful to me. So are the manuals for 
IBM’s and Microsoft’s versions of MASM. 

When you feel comfortable with what 
you are doing and are ready for advanced 
experiments, browse your bookstore for 
advanced works on—believe it or not— 
BASIC and Pascal. Limitations in the 


Items from the Bookshelf 

Bluebook of Assembly Routines 
for the IBM PC and XT by 
Christopher L. Morgan, 
paperback, $19.95. 

New American Library 
New York, NY 

Inside CP/M by David E. 

Cortesi, paperback, $26.45. 

Holt, Rinehart & Winston 
New York, NY 

Programmers Guide to the IBM 
PC by Peter Norton, paperback, 
$19.95. 

Microsoft Press 
Bellevue, WA 

A Programmers Notebook by 
David E. Cortesi, paperback, 
$16.95. 

Reston Publishing Company 
Res ton, VA 

Programmers Problem Solver for 
the IBM PC, XT, and AT by 
Robert Jourdain, paperback, 
$22.95. 

Brady Communications Company 
New York, NY 

Programmer’s Reference Manual, 
TM-150, $25. 

8080 Assembly Language 
Course, EC-1108, $54.95. 
Macro-86 Assembly Language 
Programming Course, EC-1201, 
$59.95. 

Macro-86 Algorithms Course, 
EC-1202, $59.95. 

Heath Company 

Benton Harbor, MI 49022 

800/253-0570 

Soul of CP/M by Mitchell Waite 
and Robert Lafore, paperback, 
$18.95. 

Howard W. Sams & Co. 
Indianapolis, IN 
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former language, especially, encourage 
programmers to develop ingenious PEEKS 
and POKES to address the machine direct¬ 
ly. These often can be adapted into nice 
assembly language functions for C. 

Epilogue 

Believe it or not, you’ve just read about 
the fullest available overview of CP/M 
and MS-DOS assembly language from a C 
orientation—at least so far as I know. 
There just isn’t much around, and hasn’t 
been. The subject, therefore, is tough for 
a microcomputer C programmer to get a 
handle on: a few articles, some passing 
references in books, and details of inter¬ 
facing found in some compiler manuals 
comprise the literature. It makes a 
skimpy bibliography. But since assembly 
language functions can be useful, and at 
times crucial, for working in C, I’ll return 
to the subject from time to time in “C 
Notes’’—not in an overpowering way, I 
hope, or more pedantically than usual, 
and always to give you a grasp of how to 
build tools you can use. 

Feel free to grumble about this column 
if you’re in the stage of C during which 
you are not yet in need of assembly lan¬ 
guage functions and can’t figure out why 
anyone might. Just don’t discard this col¬ 
umn or those future columns in which I 
offer such functions: when you need what 
they present, you may not find it else¬ 
where. 

Sources Mentioned 

MS-DOS Version 2 Programmer’s 
Utility Pack, (includes MASM version 
1.27), $149. 

Heath Company 

Benton Harbor, MI 49022 

800/253-0570 

DSD86: Dynamic Screen Debugger 
(MS-DOS), $69.95. 

SoftAdvances 
P.O. Box 49473 
Austin, TX 78765 
512/478-4763 

AT86: Advanced Trace 86 Debugger 
Version 2.2 (MS-DOS), $175. 

Morgan Computing Company, Inc. 

P.O. Box 112730 
Carrollton, TX 75011 
214/245-4763 

Macro Assembler (MASM version 2.00) 
(MS-DOS); contact local dealer. 

IBM 

P.O. Box 1328-S 
Boca Raton, FL 33432 

Microsoft Macro Assembler Version 4.0 
(MS-DOS), $150. 

Microsoft Corporation 
10700 Northup Way 
P.O. Box 97200 

Bellevue, WA 98009 A 
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"...a little company that has succeeded over the last five years in giving its customers a lot of value for their money..." 

- Richard O'Reilly, syndicated computer columnist 

"All the firm's programs are graced with features that the entire industry should be required to provide. Their manuals are 
the most honest in the industry." - T. R. Reid, synicated computer columnist 

"...the two most important attributes of Software Toolworks' program: they're priced low, and they work well." 

- The Washington Post 

"Unlike the software of many publishers these days, none of The Software Toolworks programs are hobbled by copy 
protection, nor does the company try to tie up its customers with mumbo-jumbo licensing agreements..." 

- The Los Angeles Times "Computer File' 

"I don't know how The Software Toolworks stays in business charging such low prices for such nifty products..." 

- David Gerrold computer columnist and science fiction author 

"It would be the best of all possible worlds if some magic diskette could be made that would transform any hardware in 
such a way as to receive The Software Toolworks' numinous software." - Wm. F. Buckley, Jr. 

"The Software Toolworks has a whole raft of programs that work, and (the company) sells them for reasonable prices. I 
strongly recommend that you get their catalog." - Dr. Jerry Pournelle computer columnist "Byte" and science fiction author 

"One of the original pioneers in low cost, high quality software, The Software Toolworks publishes over 50 
solid products in MS-DOS and CP/M for under $60." - Walt Bilofsky, chairman of The Software Toolworks 

"All products are shipped within 24 hours, come with a money back guarantee, and free technical support 
is available (though you'll hardly need it)." - Joesph Abrams, president of The Software Toolworks 


MEDIA MASTER PLUS'* - Now you can run most CP/M programs on your IBM PC or 
compatible without additional hardware. Media Master ™ which lets you read, write and for¬ 
mat over 140 different double density CP/M formats. ZP/EM ™ (included) emulates an 8080 
processor to execute CP/M software at machine language level giving you the equivalent 
of a 1 MHz 8-bit computer. Includes terminal emulation for Osborne, Kaypro, Heath/Zenith 
and DEC VT52 displays. Requires 192K RAM. For IBM PC and compatibles. - $59.95 

MYCHESS 5 - Award-winning world class chess program, featuring nine skill levels and 
over 850 opening moves. Prints moves and saves games in progress. Outstanding graphics 
display board on IBM PC and most popular CP/M computers. - $34.95 


TOOLWORKS C™ - Full featured C compiler and run time library. One of the fastest on 
the market! New MS-DOS version produces relocatable object files (.obj). MATHPAK pro¬ 
vides true 32-bit floating point and signed integer data types. CP/M and MS-DOS. 
TOOLWORKS C COMPILER - $49.95 TOOLWORKS C MATHPAK - $29.95 
AIRPORT* - You are an air traffic controller with radar screen filled with aircraft under 
your guidance. See how long vou can last without cracking. Tougher than the real thing! 
CP M and MS-DOS. - $19.95.' 

LISP/80* - Experiment with artifical intelligence programming! Over 75 LISP functions. 
Includes source for an editor written in LISP and several demonstration programs. CP/M 
and MS-DOS. - $39.95 
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H/Z89-90 PRODUCTS 


Replacement Back Panel 

Replaces the existing metal 
back panel. Adds cut-outs for 
two 5 l A" drives, 8" floppies, 
Winchesters, joy sticks, extra 
printers, modems, audio 
output, instrumentation and 
many, many more. 

RBP-200 . $35.00 


I/O Board Expansion 

Adds four additional I/O board 
slots inside the computer case. 
Now have seven right-hand and 
four left side slots. Easy DIP 
switch port selection. Now run 
up to four disk controllers or 
multiple printer boards or ???? 
EXP-700 .. $395.00 


Transportable Conversion 

Kit contains everything to 
convert an ’89-90 into a 
32-pound transportable 
computer. Nine inch amber 
CRT. Detachable keyboard. 
Conversion requires only a 
screwdriver and nutdriver. 
TRA-890 . $950.00 


4MHz Speed Up 

Plug-in unit doubles the 
computer’s speed. Eliminates 
long waits for program 
execution. Fully supports 
Heath, C.D.R., and Magnolia. No 
trace cutting. 

DSM-240 .$99.97 


Upgrade Monitor ROM 

Replaces existing monitor. 
Supports 4 MHz operation. 
Boots eleven different devices. 
Expanded commands. 

KMR-100 . $59.95 


Extra Cooling 

Extremely quiet 2Vi fan 
provides required extra cooling 
for hot machines. Easily 
mounts between the two card 
cages. Plugs inside with the 
existing fan connector. 

SCF-200 .$59.95 


DSM-240, KMR-100, RBP-200, 
SCF-200 include $3.50 S&H/unit. 
EXP-700 include $6.00 S&H/unit. 

CA residents add 6Vi% sales tax. 

All prices subject to change without 
notice. 
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EXTENDED RAM BOARD FOR THE H/Z-89 

- SINGLE PC BOARD DESIGN 
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• EMULATED DISK DRIVER 
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• LOW POWER CONSUMPTION 

HERBy(256K installed) 
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Z150/Z160 

NEW ’AT’ BUS 


• 16 BIT DATA BUS (’AT’ COMPATIBLE) 
EXPANDABLE TO 32 BITS 

• 24 BIT ADDRESS OR 16 MEGABYTES 
EXPANDABLE TO 32 BITS (4 GIGABYTES) 

- INTERMIX UP TO 8 PC and AT CARDS 

- FULLY COMPATIBLE WITH EXISTING Z150/Z160 

. 80286 CPU BOARD (’AT’ COMPATIBLE) 

- SINGLE BOARD/1 MEGABYTE MEMORY 

• OTHER PC/PC ’AT' BOARDS AVAILABLE 

T.D. ENGINEERING 
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Software Magic from Advanced 

Software 

Technologies 


Shown here is Genie “popped up’’ on a Z-110 running Lotus 
123. From the left are: The Genie main menu, the Genie 
rolodex style card file, the Genie notepad containing data cut 
from Lotus, the Genie DOS performing a directory command, 
the Genie alarm clock (at the bottom,) the Genie typewriter, 
Genie calendar, Genie Cut and paste, Genie Calculators, and 
the Genie Ascii table. 


Genie is a memory resident application. This means that once you load Genie 
it is always available for you to use. Just hit the magic keys and Genie will ap¬ 
pear (Shift-Shift: No function keys lost.) You can have Genie perform various 
tasks, and when you finish Genie goes away and you are back where you 
started. 

Here is what you get with Genie: 

• KEY MAPPER - Redefine any key on the fly, store long commands in a single 
key, and save many maps on disk. 

• TrueDOS™ - Run any MS-DOS program inside the window. FORMAT, SORT, 
BACKUP, compile, all without leaving your application. 

• CALCULATORS - you get two calculators, one regular floating point calculator, 
and programmer’s calculator for base conversions and bit operations. 

• NOTE PAD - you’ll never have to hunt for paper and pen again. Simply call up 
Genie’s Note Pad and jot down what you need. Or expand the buffer to 56K: 
Instant editor. 

• CUT AND PASTE - Cut text from any place on the screen and output it later. 
Cut long commands off the screen and into your KEY MAPPER, move data 
from your spread sheet to your word processor: Instant integration. 

• CALENDAR - schedule appointments for any year up to 9999 keep track of 
expenses, search and print the calendar. 

• ROLODEX - a name address and telephone number list that you can search 
any time. No limit on the number of cards. You can even output an address 
directly to your word processor. 

• ALARM CLOCK - Have your Genie remind you of appointments, set alarms to 
ring at any time on any day. A window appears with a reminder of what each 
of the 8 alarms is for. 

• ASCII Table - programmers never have to leaf through big books to find the 
ASCII value of a character. 

• TYPEWRITER - Knock out quick memos any time, even send ESCAPE codes 


Only Genie Gives you so much for so little. 


ADVANCED 
f 1 SOFTWARE 
\) TECHNOLOGIES 

452 West 47th Street 
New York, NY 10036 
(212) 247-0150 
ORDERS ONLY CALL 

1-800-437-4400 Ext 800 


Yes please rush me the following software for my 

_Z110/120 _PC compat. 

_ Copies of Genie @$54.95 _ 

_ Spelling Helper(s) 29.95 - 

_ Print Spuffer(s) 24.95 _ 

_ Scientific calc. 19.95 - 

_ Genie pack (I want it all) 

Saving $40 $89 - 


to your printer. Cut a portion of a spread sheet and paste into the typewriter for 
quick printouts. 

• SCREEN SAVER - Automatic phosphor protector for your tube. Genie will even 
let you blank the screen manually to discourage peepers. 

• COMMAND STACK - Lets you access up to the last 2K worth of commands 
you typed. 

Best of all with Genie you only have to load what you use. If you don’t need to 
use an ASCII chart don’t load it. Need extra alarms? then load two alarm 
clocks. Your own personal Genie. 

And now Genie user’s have the advantage of Genie accessories, which can 
be installed and accessed like any Genie function - any time: 

• a Scientific Calculator more powerful than most real calculators. 
Has a full range of math, science and statistical functions and very 
high accuracy. 

• a Spelling Helper™ To help you find the correct spelling without 
leaving your word processor. 

• a Print Spuffer™ (spooler/buffer) to speed and manage all your 
printing. 

• a development pack to let you write your own pop up programs, 
including many routines for windowing, and source code for our 
Rolodex. Writing pop ups is a snap. (Please call for details) 
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Computer Diversity 
in Chicago 

HUGCON V was for users of the H8, HU, H/Z89-90, HIZ100, H/Z150, H/Z200, 
Z171, ZP-150, HERO 2000, and a few more Heath/Zenith computers. 

Beverly Voigt 



They’ve got a strong past and an eye on 
the future. And they’re everywhere. 
HUGgies came to the Fifth International 
Heath/Zenith Users’ Group Conference 
from such faraway places as Guam, 
Puerto Rico, Canada, West Germany, 
France, Mexico, and Hawaii. Only six 
states in the U.S. weren’t represented. 

Held again this year at the Hyatt Re¬ 
gency O’Hare in Rosemont, Illinois (just 
outside Chicago), August 15-17, the con¬ 
ference attracted both old hands and 
newcomers. Apparently to reach a wider 
audience, HUG had placed an advertise¬ 
ment for the conference in the Chicago 
Tribune. The ad announced some details 
of the conference, and promised industry 
seminars and low prices on IBM-compat¬ 
ible computers and software. 

Many of the major vendors in the 
Heath/Zenith world, and some who cater 
to generic IBM compatibles such as the 
T50, showed their wares. Six staff 
members of Sextant travelled from Wash¬ 
ington, D.C., for the weekend. This was 
my first conference, and I was able to 
acquaint myself with some of the Heath/ 
Zenith notables—both people and prod- J 
ucts—that I had only read about. $ 

One product that everyone had only J 
read about was the elusive version 3 of the ^ 
Heath Disk Operating System (HDOS). s 
Would it be announced that it’s finally £ 
ready? 

We registered in the lobby, and filled 
out a Heath Company questionnaire. (You 
had to return it to be eligible for the 
drawing for a Smart Outlet Box on Sat¬ 
urday night). Then we set up our booth 
and waited for the onslaught of HUGgies. 

The onslaught was a minor one. Many 
of the people who stopped at our booth 
were already familiar with Sextant. Many 
stopped to get to know the people behind 
the magazine. And a few explained to us 
that our magazine does not carry enough 
material on IBM compatibles to interest 

Beverly Voigt is Sextant’s editorial and 
production assistant. She’s a native of 
Pittsburgh, Pennsylvania, and likes to 
visit there occasionally. 


them. Overall, the vendor area on Friday 
evening was fairly slow. 

Later that evening, HUGgies gathered 
in the Rosemont Ballroom for HUG- 
CON’s Grand Opening. A short presenta¬ 
tion, with slides, described some new 
products from Heathkit—ranging from 
ham-radio gear to kits designed to be 
one-night projects. A new kit-builders 
magazine from Heath was also an¬ 
nounced. 

Then Miles Hoffman, marketing direc¬ 
tor for Heath Company, gave the 
audience a description (garnered from 
market surveys, and supplemented with 
charts and graphs) of the typical HUGgie: 
he’s a well-educated male, an early 


HERO 2000 is 
Heathkit’s newest 
educational robot. 
He’s intelligent and 
friendly, and was 
gracious enough to 
sign his autograph 
for some fans. 


adopter of new technology, and makes a 
higher than average income. 

An auction followed, at which HUG 
sold a package of first issues of Sextant, 
Buss, REMark, and H-Scoop to the 
highest bidder. They also auctioned off 
the original version of HUG’s symbol— 
six H8 side panels arranged in a “star.” 

The city 

Some of the Sextant staffers had 
decided it was time to head for that 
toddlin’ town—Chicago—which is only 
about 20 miles from Rosemont. 

Having never been west of the Ohio 
Valley, I’d never seen Chicago, and was 
eager to discover a new city. 
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The concierge at the hotel had told us, 
“You have to, like, go to Rush Street.” So, 
like, we went. Rush Street is known for its 
nightlife, and was awfully exciting. 

We had dinner at a restaurant that was 
open to the wind. Appropriately, there 
were hurricane lamps on the tables in¬ 
stead of candles. It had atmosphere all 
over the place. 

After a few cups of coffee, we walked 
through the town. The wind was some¬ 
times at our backs and sometimes in our 
faces, but always there and always strong. 

The view from the 94th floor of the 
John Hancock Building is great, even if 
the height did leave me a little nauseous. 
From up there, we could see much of 
Chicago’s great architecture, but I think 
it’s even better from the ground. 

Janet Stotts, Sextant’s former ad man¬ 
ager, found that Lake Michigan is cold, 
even in August. We almost lost her to its 
chilly depths when she slid on the con¬ 
crete beach. I’m not sure we would have 
been brave enough to dive in after her. 

The sizzlers 

On Saturday morning, the conference 
began in earnest. So did the selling. 
Veritechnology (which runs the Heath 
stores) offered some HUGCON “siz¬ 
zlers”: a ZF240, with 512K RAM and a 
1.2M floppy, for $1,995; a refurbished 
ZFL-171 portable, with dual drives and 
256K RAM, for $999; a ZP150 laptop, 
with 32K RAM, for $499; a NEC Multi¬ 
synch color monitor for $549; the STB 
EGA video card for $335. John Walker, 
Sextant’s technical editor, bought a refur¬ 
bished TlO with a hard disk for $899. All 
of HUG’s software was discounted 30% if 
you ordered it at the conference. 

Gemini Technology had their own 
room in the vendor area, with two TV 
screens showing videos promoting their 
company and products (including their 
IBM-emulator board for the TOO). 

EWDP Software, Inc., offered their 
Filebase data base manager (for CP/M, 
MS-DOS, and PC-DOS). TMSI (Techni¬ 
cal Micro Systems, Inc.), showed Write- 
Hand-Man, their memory-resident desk¬ 
top utility for the H8 and ’89; they also 
demonstrated their H-1000 board, which 
equips an H89 with a 16-bit CPU. 

The Software Toolworks was there 
selling their already low-priced soft¬ 
ware, such as Lisp/80, $39.95; My- 
Write, $49.95; My Spell, $49.95; MyCalc, 
$59.95; and their C compiler for $49.95. 

Newline Software had good news and 
bad news: all their H89 software was 
marked down at least 50%, but, they said, 
“Once it’s gone we won’t be manufactur¬ 
ing any more.” They are also discontinu¬ 
ing some software for the Z100. 

And Xerox was demonstrating their 
ZP-10E Laser Printer. It did some great 
things, but seemed very slow when print¬ 
ing graphics. 

Throughout all this, HUG was drawing 
names and announcing over the loud¬ 


speaker winners of prizes donated by the 
vendors. 

The desktop publishing seminar 

HUGCON’s seminars began on Satur¬ 
day morning. All the ones that I attended 
were informative and interesting. The 
first was given by Arthur Seebach on 
“DeskTop Publishing, or The Dot Matrix 
Printer and Beyond.” Mr. Seebach, a 
mathematician and computer scientist at 
St. Olaf College in Minnesota, gave a 
brief history of typesetting, then outlined 
the microcomputer’s revolution of the 
whole process. 

He started with Gutenberg in 1453 and 
the invention of movable type, which, he 
said, had an effect on the world similar to 
that of computers. With movable type, it 
was possible to make a master of a letter, 
then make copies from that master. As a 
result, the price of books went down, 
communication increased, and people 
began to write books merely because they 
could be printed. That situation gave rise 

The new technology 
has made major 
changes in who does 
what in the printing 
business. 

to the invention of the “how-to” book (in 
the late 18th century), and the world was 
a better place. 

At this point, Mr. Seebach posed the 
rhetorical question of what will happen as 
a result of the development of computers. 
As the motel industry was a result of the 
invention of the automobile, computers 
may cause something wholly unexpected. 
Just the fact that people need no longer 
rely on outside industry to produce in- 
house publications could have interesting 
consequences. Give some people a desk¬ 
top publishing system, and you never 
know what might happen. 

Back to the present. Mr. Seebach dif¬ 
ferentiated between “word processing” 
software, which lets us write and do 
simple typewriter-style printing, and 
“desktop publishing” software, which can 
do formatting and layout of typeset copy. 
Some packages are able to do both. And 
the newer printers can handle whatever 
the software commands. With the right 
stuff, you can do it all. The computer lets 
you avoid the “grunge” work of writing 
(such as cutting and pasting), and it lets 
you do the layout, printing, and graphics 
without getting your fingers dirty. 

Proportional spacing and other ameni¬ 
ties allow for a prettier page. Output from 
printers without proportional spacing can 
look much like a typewriter’s output. But 
software is available that makes use of the 
computer’s ability to calculate tiny frac¬ 


tions of space. As a result, lines of text 
with right-justified margins will be nicely 
spaced—much more pleasing to look at, 
and easier to read. 

Ideally, a desktop publishing system 
allows for complete in-house (or in-office) 
publishing, with little or no need for out¬ 
side experts in printing or graphic arts. 

But the microcomputer introduces a lot 
of complexity into producing a printed 
page. Creating a table, a fairly simple task 
on a conventional typewriter, becomes 
more complicated on a computer, espe¬ 
cially with software that allows for 
proportional spacing—you can’t count on 
the widths of all characters to be equal. 
But the better software lets the computer 
handle the complexities, allowing the us¬ 
er to concentrate more on the design 
aspects of layout. 

The new technology has made major 
changes in who does what in the printing 
business. Now someone with a complete 
desktop publishing system can do the 
actual typesetting (specifying fonts, point 
size, etc.)—something that normally is 
left up to a professional in the typesetting 
field. 

Two types of software are available for 
word processing. One kind is known as 
WYSIWYG—“What You See Is What You 
Get.” That is, what you see on the screen 
is what you get when it’s printed. This 
kind of software is easy to learn (especial¬ 
ly for beginners in word processing) be¬ 
cause it works much like a conventional 
typewriter. But its detractors call it 
“What You See Is All You Get.” 

The other type of software uses what is 
referred to as “mark-up language.” With 
this, you insert typesetting codes into the 
text, and let the typesetting software han¬ 
dle the interpretation. 

As you get away from a typewriter-like 
device (such as a computer running 
WYSIWYG software), the complications 
increase. But, again, the better software 
will handle that itself. All you have to 
learn is what the software expects, and it 
does the rest. 

The complexity gives you a lot of 
power. In general, a computer is able to 
calculate fractions of space in a way that a 
typewriter—and even a pocket calcu¬ 
lator—could never do. 

And you can be much more per¬ 
snickety about details. According to Mr. 
Seebach, who majored in Greek in col¬ 
lege, ancient languages didn’t even use 
spaces between words. It’s a fairly recent 
invention. But space is now such a con¬ 
cern that someone with an experienced 
eye (such as our assistant publisher, John 
Gill) can tell if something on the page is 
off just a point. 

On the subject of printers, Mr. 
Seebach pointed out some limitations in 
present technology. The typical dot¬ 
matrix printer prints 180-240 dots per 
inch. A laser printer can print 300 d.p.i. 
But newspaper photos print only about 85 
d.p.i. So how come these photos look 
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better than those reproduced on even the 
newest printers? 

The answer is that dot-matrix and laser 
printers are not yet able to control dot 
size. Newspaper photos use halftones. To 
produce gray in a photograph, lots of tiny 
dots with lots of space between them are 
used. Dark areas require large dots with 
very little space between them. 

Despite the limitations, technology is 
moving fast, and we can expect that the 
computer will be able to do a lot more for 
us in the way of desktop publishing. 

The announcement 

Meanwhile, back in the vendor area, 
Bob Ellerton, HUG Manager, made the 
announcement: HDOS 3 is ready, and 
will be available on the HUG Bulletin 
Board. There is 'one problem, though. 
We found out later that HDOS 3 takes up 
about five disks, or half a megabyte of 
memory. That would take a long time to 
download. We’ll see what happens. 

The bull session 

Bruce Denton, of D-G Electronics, 
again hosted the popular Hardware 
Workshop. But this year, he decided to 
call it the “Hardware ‘Bull’ Session For 
Old And New Computer Users.’’ He skill¬ 
fully fielded questions from the audience. 
When he wasn’t sure of an answer, he 
called on other members of the audience 
to help out, and they did. 

As a prelude, he asked the audience 
about the machines they own. Most 
owned an H8 or ’89. And many owned a 
TOO. A few said they had a 150 or 
something newer. Then he asked how 
many had two or more different ma¬ 
chines. The results were interesting: only 
a few of those who had a 150 also had an 
older machine, but many who owned a 
TOO also had an ’8 or ’89. 

Someone asked about the possibility of 
allowing the ’89 to run software that was 
written for the Microsoft Disk Operating 


System (MS-DOS) on IBM compatibles. 
To those who might find this sacrilegious, 
don’t worry. Mr. Denton answered that 
too many changes would have to be made 
to the ’89; for one thing, the keyboard 
doesn’t have enough function keys. The 
conversion just wouldn’t be feasible. You 
might as well buy one of Zenith’s IBM 
compatibles. 

Someone else asked why the prices of 
some boards for the older machines 
remain so high. Mr. Denton’s answer— 
“Because they’re not selling many of 
them”—led into a discussion of why 
vendors need the support of owners of 
Heath/Zenith equipment. 

Mr. Denton told us that HUGgies call 
him to ask, “Why aren’t you doing any 

If you need a certain 
board, let them know 
you’d buy it if they 
offered it. 

more H8 products?” But when he asks 
them, “What would you like to see for the 
H8?” they can’t give him any ideas. 

Vendors need to be informed of the 
kinds of equipment people need for their 
machines. They also need to know that 
there are people who will buy their 
products: “We’re not going to try selling a 
product that we don’t think is going to 
sell.” So, he said, if you need a certain 
board, let them know you’d buy it if they 
offered it. With no customer input, 
vendors start to think that “either they 
don’t need anything, or if we do some¬ 
thing, they’re probably not going to buy it 
anyway.” 

The festivities 

After a long day of seminars and sell¬ 
ing, we headed back to our hotel. (We 


were staying at the Holiday Inn across the 
way from the Hyatt.) The hotel’s outdoor 
pool was almost as chilly as Lake Michi¬ 
gan—like ice water, according to John 
Gill. But we decided to sit by the edge 
and let our feet dangle in the water. It 
wasn’t too cold once we got used to it. 
After a little hesitation by all of us, Janet 
slid in with a “What the heck,” and then 
we were all in, and it wasn’t so bad. (The 
hotel has an indoor pool in the works.) 

We got back to the Hyatt in time for the 
banquet—the highlight of the confer¬ 
ence. Dinner was pretty good—stuffed 
chicken, broccoli, and something involv¬ 
ing a tomato. After the tables were 
cleared, the speeches began. 

Bob Ellerton again announced the ar¬ 
rival of HDOS 3: “I have the disks,” he 
said, “providing they’re not blank.” 

Joseph Schulte, president of Veritech- 
nology Electronics Corp., and William 
Johnson, president of Heath Company, 
also spoke. 

The award for Outstanding Heath/ 
Zenith Vendor of the Year went to Kres 
Engineering. Bill Moss, “a cornerstone 
of the Heath Users’ Group,” received a 
lifetime membership to HUG. Others 
recognized for their contributions were 
Pat Swayne and Dr. Richard Mueller. 

The past and the future 

The keynote address was given by Mr. 
Lou Frenzel, who was computer product¬ 
line manager for the Heath Company 
back when Heath first invaded the world 
of digital computer electronics. He was 
also behind the formation of national 
HUG in 1978. Mr. Frenzel described the 
evolution of the H8, H89/90, and the 
H/Z100, and his part in their develop¬ 
ment. 

He went on to make some predictions. 
The future, he said, is in IBM compatibil¬ 
ity and in 80286-based machines. We can 
also look for 32-bit machines to become 
increasingly available. Unix, with its 
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multi-tasking capabilities, will be the op¬ 
erating system of the future. Also, great 
strides will be made in communications. 
There will be more standardization 
among local-area networks and, as a re¬ 
sult, they’ll be more widespread. The 
desktop publishing industry will experi¬ 
ence an even bigger boom, especially 
when prices of laser printers and other 
equipment come down. 

The conference organizers seemed to 
have been on the same wavelength as Mr. 
Frenzel. The scheduled lectures included 
an introduction to local-area networks, a 
PC Hardware Workshop, talks on Hyper- 
ACCESS (Hilgraeve’s communications pro¬ 
gram), Xenix (a Unix-like package for MS- 
DOS machines), and MS-DOS 3. 

In the software field, one area that Mr. 
Frenzel predicted would become much 
more important is artificial intelligence 
(AI). He defined AI software as software 
that mimics the way the human brain 
works—the way it thinks, reasons, de¬ 
cides, creates—in short, the way it learns. 
As robotics attempts to imitate the physi¬ 
cal actions of human beings, artificial in¬ 
telligence attempts to imitate our mental 
processes. One difference, though, 
between the education of a human being 
and the education of a computer is that 
the computer won’t make the same 
mistake twice. It won’t forget what it’s 
learned. 

As Mr. Frenzel pointed out, “the whole 
idea behind AI is to make computers 
smarter, make them more productive, 
make them more friendly, make them do 
more interesting things by making them 
more intelligent.” An AI program is intel¬ 
ligent because it can modify its own data 
base. 

Though the ideas behind AI might be 
easily described, the difficulty seems to 
be in implementing those ideas. At 
present, we are able to program a 
computer to perform complicated mathe¬ 
matical functions. But we don’t yet know 
how to teach it to do some of the simple 
things that a five-year-old child can do. 
The reason is that we don’t know enough 
about how the child knows things. 
Attempts at AI programming have raised 
a lot of questions about how human 
beings learn, and we’re still in the process 
of trying to answer them. 

(Peter Halverson, in his ZLOGO lec¬ 
ture, said that he had recently heard AI 
defined as “anything we can’t do yet on a 
computer.”) 

Artificial intelligence, as a concept, has 
been around for at least 30 years. But 
until recently, it was too impractical to be 
commercially viable. Programs written in 
AI languages like Lisp or Logo frequently 
need great amounts of memory, and there 
were no personal computers with the 
capacity to handle them. But now there 
are, and, according to Mr. Frenzel, great 
strides are being made in AI technology. 

But what is the purpose of artificial 
intelligence? Now that it’s practical, what 
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is it practical for? 

Mr. Frenzel made a distinction be¬ 
tween information and knowledge. He 
defined “information” as raw data, facts 
and figures. But “knowledge,” he said, is 
understanding gained by analysis of the 
raw data. He pointed out that convention¬ 
al software essentially performs data 
processing, i.e., processing of informa¬ 
tion. But AI software works with knowl¬ 
edge. Artificial intelligence programs are 
able to form a “knowledge base”—as 
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opposed to a conventional data base—for 
us to tap into. 

One subfield of artificial intelligence is 
known as expert systems. Expert systems 
programs emulate a human expert in 
some field. Information pertaining to that 
field is boiled down to form an “advisory 
system” that novices in the field can use. 
One of the advantages of an expert system 
is that it draws on the expertise of not just 
one human expert, but represents the 
knowledge of many human experts in that 
field. 

Another subfield of AI is natural-lan¬ 
guage processing. One aspect of this in¬ 
volves programming the computer to rec¬ 
ognize human voice commands in the 
same way that it recognizes keyboard 
commands. It allows you to talk to a com¬ 
puter (or robot) the way you would talk to 
another human being. 

As Mr. Frenzel noted, much software 
in the AI field is now available. Some 
software uses an “expert-systems shell,” 
which allows the user to create an expert 
system without having to do the actual 
programming. 

Also, said Mr. Frenzel, AI will slowly 
but surely creep into the software that 
you’ll be using. Already, expert systems 
are embedded in some pieces of software, 
the program itself tapping into an expert 
system to get its information. So, AI may 
not be immediately recognizable as such, 
but it’s there. 

(If you’re interested in learning about 
AI, you may want to look at the April 1985 
issue of Byte magazine. It contains some 
essays written by people who are doing 
important research in the field.) 

Toward the end of his speech, Mr. 
Frenzel gave his own description of the 
typical HUGgie: “You want to learn,” he 
said. “You’re curious and you’re motivat¬ 
ed.” Heath’s computers were designed 
with that in mind. It was assumed that 
they would be used as “teaching ma¬ 
chines.” 

In light of this, he said, HUGgies 
should ask themselves: What do I see 
myself doing with my computer a year 
from now? Two years from now? They 
should look to the future and imagine 
how they will grow with the technology. 

After Mr. Frenzel’s speech, Bill 
Johnson elaborated a little on the history 
theme with a story about their visit to 
Digital Equipment Corp. to learn about 
DEC’s 16-bit machines. (Eventually, 
Heath Company would offer the Hll, 
their version of DEC’s PDP-11 com¬ 
puter.) DEC gave them a warm recep¬ 
tion, and the president told them that he 
and his brother, the founders, began with 
$76,000 to start the company. Out of that 
money, he said, $23,000 went to Heath 
Company for materials such as signal 
generators and power supplies. The 
hardware that DEC needed to get off the 
ground was built in their own 
basement—from Heathkits. 


The excitement 

The handing out of prizes seemed 
to be a rerun of the St. Louis HUGCON 
in May, where Bob Ellerton and Jim 
Buszkiewicz played Monty Hall and Don 
Pardo, respectively. (See “The Spirit of 
St. Louis” by Kieran P. O’Leary, in 
Sextant #24, September-October 1986.) 
In this version of “Let’s Make a Deal” 
they handed out, among other things, an 
H241 and an H158, each with a 20- 
megabyte Winchester and color monitor, 
a dot-matrix printer, and a few 100-packs 
of Dysan disks. (“Remember,” said Don 
Pardo, “on a clear disk, you can seek 
forever.”) 

Toward the end of the game, it turned 
into a mad giveaway, with Joe Schulte and 
Bill Johnson playing duelling donors, 
each trying to top the other at giving away 
computer systems. 

Speaking of excitement, we returned 
to Chicago after the banquet. The 
restaurants were packed, the clubs were 
jam-packed, and the streets were 
chunky-jam-packed. It was, from what I 
hear, a typical Saturday night in Chicago. 

More seminars 

I attended more seminars on Sunday. 
Walt Bilofsky’s presentation, “Thtarting 
With Lisp,” was a good primer for the 
Lisp programming language. He gave a 
brief introduction, then got right into a 
sample program. 

Lisp has been described as “an assem¬ 
bly language for AI programming.” It got 
its name from “list-processing language,” 
which points up how Lisp works: it relies 
on direct evaluation of “lists,” its funda¬ 
mental data structure. 

Lisp makes heavy use of recursion, a 
principle in which a function can call 
itself. It thereby allows very short 
programs to do a lot of work. (They may 
need a lot of storage space, though, to 
keep track of everything.) As Mr. Bilofsky 
said, “Recursion is as natural in Lisp as 
swimming is to ducks.” 

He used the example of combining two 
different shopping lists that have some 
items in common. A program in Lisp to 
combine the lists can be written in only a 
few lines of code. 

(Mr. Bilofsky’s company, The Software 
Toolworks, sells a version of Lisp that he 
says will help you learn the language. It’s 
called Lisp/80.) 

Another lecture I attended, on 
ZLOGO, was given by Peter Halverson, 
the man who wrote the program. 
ZLOGO, offered by Colorworks, is an 
implementation of the Logo program¬ 
ming language for the Zenith machines. 
There are two versions of ZLOGO—one 
for the TOO and one for the T50 and other 
IBM compatibles. 

Logo was developed at MIT to teach 
kids to program. It uses “Turtle 
graphics”—so called because scientists at 
MIT originally used plastic turtles with 
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cables attached so that kids could move 
them. The concept was later adapted to 
the computer screen, and the name 
stuck. Using Turtle graphics, kids learn to 
program by tackling problems such as 
how to create pictures, and they also end 
up learning basic geometry (angles, lines, 
etc.) as they play. 

Logo makes use of the “magnetism fac¬ 
tor”—people become glued to the ma¬ 
chine, and learn faster as a result. Also, it 
is implemented as an interpreter, which 
can run code as soon as it’s typed in, so 
kids can get immediate gratification from 
just a few lines of code. 

Logo is a derivative of the Lisp lan¬ 
guage; therefore, it is list oriented. 

Mr. Halverson’s implementation of 
Logo has a built-in editor, and provides 
very readable error messages. He told us 
that he feels it’s very important for a 
language to be self-explanatory, since the 
error messages may actually help to teach 
the user about the language. 

ZLOGO comes with over 150 primitive 
commands. (The IBM version of Logo 
has about 200; the Apple versions have 
about 150.) But Mr. Halverson stressed 
that there are trade-offs with the H/Z 
version. Though he included fewer com¬ 
mands, he’s implemented some com¬ 
mands that the other versions don’t have. 
And his version is still fairly new. So, 
users who report bugs will receive a free 


update; otherwise, an update will cost 

$ 20 . 

ZLOGO also supports the 8087 math 
coprocessor, and makes use of all avail¬ 
able memory. 

Also, ZLOGO uses ordinary ASCII 
text files to control much of its configura¬ 
tion. For instance, you could go in and 
literally translate all the error messages 
and names of commands to Spanish or 
French. 

Another feature of Logo is that pro¬ 
grams written in the language are able to 
use a logic structure called a decision 
tree. A program can be written that will 
ask questions based on yes or no answers. 
Each succeeding question will be based 
on the answer given to the last question. 
Expert systems make great use of this 
structure. 

To demonstrate an expert system in 
action, and to show how an AI program 
could evolve and learn, Mr. Halverson 
called up a sample program, named 
MECHANIC. Then he got into MECHANIC’S 
NOSTART data base. This data base dealt 
with the problem of why a car won’t start. 
To see if the computer could come up 
with a correct diagnosis of what was 
wrong with the car, he asked the 
audience to suggest one reason why a car 
wouldn’t start. He got many responses, 
among them, “made in Detroit.” But he 
finally settled on the suggestion that the 


weather was too cold. 

As Mr. Halverson went through the 
program, it asked him specific questions 
about possible reasons for the car not 
starting, each question requiring a yes or 
no answer. For example, the first ques¬ 
tion was, “Does the starter crank the 
engine?” He responded “Y” for yes. As a 
result of that answer, the data base then 
asked, “Are the points burned, pitted, 
dirty, or not functioning?” (Had he 
responded “N ”, for no, to the first ques¬ 
tion, he would have been asked a differ¬ 
ent follow-up question based on the fact 
that the starter does not crank the 
engine.) 

After going through a series of 
questions, each one based on the answer 
to the previous question, the program 
finally asked, “Could it be there is no 
gas?” When he responded that there was 
gas, the computer gave up, saying, 
“Please find the problem, and tell me 
what the problem was.” When the answer 
“too cold” was entered, it responded by 
asking for a question whose answer is yes 
if “too cold.” Mr. Halverson typed in “Is 
weather cold?”. 

The disk drives started to churn. “Now 
it’s learning,” he told us. The data base 
was entering this new question—“Is 
weather cold?”—into its decision tree at 
the correct place. The next time this 
problem comes up, it’ll be able to suggest 
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PIBTERM communications, EasyPC diagnostics, etc., $40 
I/O board with single IBM COM port, $89, with 2 COM 
ports, game port & clock, $125 
MATH CO-PROCESSOR SUPPORT, UCI daughter board for 
use with Easy PC or plain Z-100 motherboard. $69 
8087-2 math chip, 8mhz, $159. UCI board & chip, $219, 
80287-3, Math chip for Z-200, 6mhz, $189 

HARD DISK UPGRADES - CDR’s new disk controller for 
Z-100, 2 card kit with hardware/cables, $559 
packaged with half high, 80-90ms hard disks in these 
sizes: 20MB/$895, 30MB/$995, 40MB/$1095 
HIGH DENSITY CONTROLLER card for PC clones by 
Adaptec, increases formatted capacity 50% ,$179 
packaged with 30MB hard disk for $559, 45MB/$699 

OTHER PRODUCTS: 

V-20 by NEC for faster 8088 execution, 8mhz version, $15. 
V-30 by NEC for faster 8086 execution, 8mhz version, $19. 
CP/M Emulation software, some Z80 instructions, with V-20 
mode for 8080 instruction execution, $30 
Z-100 speed-up kit, 7.5mhz by CDR, $39 
CLOCKS - Call regarding new ROM based clocks! 

ZCLK daughter board clock for Z-100 by FBE, $79 
1.2MB 5-1/4” floppy drive, $169, cable for Z-100, $30 
“AT” type floppy drive that runs on REGULAR 5-1/4” PC 
controller, but reads/writes “AT” 1.2MB format, $159 
2400 baud Anchor Lightning external modem, 

“HAYES”, $329. 

We specialize in the unusual, 
state of the art upgrades. Our 
prices reflect the current 
market as of 9/1/86, but they 
are subject to change up or 
down, especially the RAM 
prices. Quantity Discounts 
available. P.O.’s accepted 
from government, schools, 
and large corporations. 

Shipping and handling 
charges are $5 for small 
chip kits, $10 for large board 
sets, etc. add extra $5 for 
P.O.’s, COD’s, & A.P.O.’s. 


Graymatter Application Software 

1601 TOWNSHIP LINE ROAD 
NORRISTOWN, PA 19401-1146 
(215) 279-4460 
BOB GRAY 

Visit our booth at CHUGCON or WRHUGCON 
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Microsystems Call 

$ ^ 

<-» <-> 

Communications Software 

COMPLETE COMMUNICATIONS 

■ Unmatched VT-100 emulation including true 132-column, 
double-high, and double-wide characters. 

■ Error-free file transfers with XMODEM protocol. 

■ Communicate with VAX computers, other PCs, or 
information utilities such as The Source SM , CompuServe™, 
DELPHI™, News Net™ or MCI Mail SM . 

EASY-TO-USE 

■ Scripts, keyboard macros, and Hayes auto-dialing simplify 
your routine communications tasks. 

■ "Hot-key" leaves your DOS only a keystroke away. 

■ Lotus™-style menus are simple to learn and use, yet never 
get in your way. 

VALUE 

■ Introductory price of . For your Z-100, Z-150, Z-200, 
IBM™ PC, or compatible. 

■ Not copy-protected. 60-day guarantee. 

■ Send this coupon todav! 

I want complete communications, send me_copies of Call 

at the introductory price of $49 each. 

Please include $1.50 for shipping, California residents add $3.43 
sales tax. 

NAME: __ 

ADDRESS:_ 

CITY:_STATE:_ZIP:_ 

Mail to: Microsystems Company (408) 358-2224 

16987 Frank Ave., Dept. 61, Los Gatos, CA 95030 
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CPA II 

COMPUTERIZED PERSONAL ACCOUNTING 
ACCLAIMED BY USERS THROUGHOUT 
NORTH AMERICA 

• Any number of Checking Accounts, Vendor and Cash 
Accounts. Automatic reporting of accounts due. Auto¬ 
matic posting to Vendor accounts. 

• Issue checks with up to 5 separate categories and/or tax 
flags per check. Print your checks with automatic ad¬ 
dressing and memo line. Automatic checkbook recon¬ 
ciliation. 

• Screen or line-printer Bar-Graphs of monthly Actual vs. 
Budget for the year. Generate Income Statement, spread¬ 
sheets, a wide range of other reports. Can be used with 
any printer. 

• Fully compiled; fast and efficient; ZDOS or MS-DOS; 
$95.00. 


3D-DRAW 

3-DIMENSIONAL CAD SYSTEM 

LEARN COMPUTER-AIDED-DESIGN TECHNIQUES 
ON YOUR Z-100 


Develop 3-D 
Structures 

Plotter 

Support 

Complete 

Utility 

Package 



Manipulate 
Contour Surfaces 

Powerful Low-Cost 
Design Tool 

Study Your 
Design From 
Any Viewpoint 


6 Programs: sample files; screen displays; manual; ZDOS 
or MS-DOS; $95.00. 



_ REICHERT DIGITAL SYSTEMS _ 

29 BLAZIER RD. WARREN, N.j. 07060 (201) 469 3854 
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a new answer. 

Mr. Halverson recommended ZLOGO 
as a good alternative to BASIC as a first 
language for beginning programmers. He 
also stressed Logo s status as the de facto 
standard teaching language in primary 
schools. And people interested in 
graphics, especially those who want to 
experiment with the Z 100’s graphics ca¬ 
pabilities, will find much in ZLOGO to 
play with. 

For those who were interested in read¬ 
ing more about Logo, Mr. Halverson cir¬ 
culated a couple of books on the subject 
through the room. One, for beginners, is 
called Logo: An Introduction (by J. Dale 
Burnett, Creative Computing Press, 
Morris Plains, N.J., 1982). It’s subtitled 
“For teachers, students and other com¬ 
puter users new to the philosophy and 
methodology of Logo.” 

The other book is geared toward those 
who are interested in the technical side of 
the language. It’s called Turtle Geometry: 
The Computer as a Medium for Exploring 
Mathematics (by Harold Abelson and 
Andrea diSessa, MIT Press, Cambridge, 
Mass., 1980). 

(You may also want to look at William 
Locke’s “Z100 Notebook,” which appears 
elsewhere in this issue. He covers VSS- 
Logo, another version of Logo for the 
Z100, and gives some information on 
Logo users’ groups.) 

Version 3 of MS-DOS was the subject 
of another lecture I attended. Given by 
William Adney, Sextant author and con¬ 
tributing editor for REMark magazine, 
the talk centered on the technical 
aspects, and much of it was over my head. 
Fortunately, he will cover the same 
ground in his upcoming columns in 
REMark. 

More excitement 

The final few hours of the conference 
were marked by a flurry of sales and 
giveaways. Tom Jorgenson of First Capi¬ 
tol Computer gave away some software by 
literally throwing floppy disks to a crowd 
in front of his booth. 

More in the future? 

At this year’s conference, national 
HUG seemed to focus on defining the 
role of Heath/Zenith computer users in 
the scheme of things. Apparently, they 
don’t want to be left behind. The parts 
that artificial intelligence and IBM 
compatibility played in the conference 
seemed to point up that fact. 

But it’s good to see that the Heath/ 
Zenith users community is not just trying 
to keep up with trends. It also has its eye 
on fields that may prove to be really im¬ 
portant. At HUGCON this year, most of 
the talks on the latest developments were 
given by members of the H/Z commu¬ 
nity, so apparently they’re not only inter¬ 
ested, they’re also on top of what’s 
current in those fields. And considering 
the impact that artificial intelligence is 


having, and will continue to have, on 
fields such as education, medicine, busi¬ 
ness, and agriculture, Heath/Zenith 
should be right in the swim of things. 

All in all, HUG should be proud of 
what it’s done in the past and where it’s 
heading. I was very impressed with the 
quantity and quality of products available 
for the Heath/Zenith world. I was equally 
impressed with national HUG’s foresight 
in regard to how computers will figure in 
society. Maybe the decision to go with 
IBM compatibility wasn’t a rash one—in 
the long run, at least. The Heath/Zenith 
community is now open to software that 
much of the rest of the world is using. The 
fact that the software was written for the 
IBM machines isn’t necessarily limiting. 
Heath/Zenith, with its better built ma¬ 
chines and its concern for what’s ahead, 
should have a real future not only in the 
computer industry, but in that industry’s 
impact on other endeavors. 


Additional Information 

Lisp/80 (specify MS-DOS or CP/M), 
$39.95 plus $3.50 shipping. 

The Software Toolworks 
9713 Santa Monica Blvd., Suite 204 
Beverly Hills, CA 90210 
213/278-8450 

ZLOGO (specify TOO or T50), $65 plus 
$3 shipping and handling. 

Colorworks 
5337 East Bellevue 
Tucson, AZ 85712 
602/323-9674 

MS-DOS version 3, $150. 

Model #OS-63-30 for TOO; model 
#OS-63-31 for T50. 

Heath Company 
Benton Harbor, MI 49023 
800/253-0570; in Michigan and Alaska, 
616/982-3411 A 



LiteDrive “gives your Zenith Z-171 what 
you really wanted in the first place 

P remier Technologies, Inc. 

introduces the first 
internal hard disk designed 
specifically for the Zenith 
Z-171 laptop. 

The LiteDrive™ makes the 
already exceptional Zenith Data 
Systems Z-171 portable computer 
even better! 

LiteDrive™, the most 
innovative recent achievement in 
storage technology, combines the 
increased speed and memory of a 
hard disk sub-system with the 
convenience of a truly portable full 
function laptop PC. 

With the advent of the 
information explosion, most 
computer users find themselves 
restricted by the limitations of the 
floppy disk. More and more, they 
have relied upon the increased speed 
and memory of hard disk systems. 

Truly Portable 

Until now, owning a hard disk 
meant either lugging around an 
external drive unit for your laptop 
or being locked into the office to 
get any work done. But with the 
LiteDrive™ you can enjoy the 
portability of your Z-171 laptop 
and the performance of a hard disk. 

The 10 megabyte sub-system, 
installed in place of the second 
floppy, dramatically increases the 

MS-DOS is a trademark of the Microsoft Corporation 


TeMTH I data 

I systems 


Z-171 Specifications 


80C88 CMOS processor 
MS-DOS 2.11 

256K RAM standard (Expands to 640K) 
Dual 5.25" DSDD drives 
Flat 10" backlit LCD 
25 lines of 80 characters 
640 x 200 resolution 
Standard QWERTY keyboard 
Serial & parallel port standard 
Optional: RGB video, battery pack, 
carrying case, memory upgrade, and 
internal modem 

14.3 lbs — 9.5 x 13 x 6.6 inches 


Z-171's performance by adding 27 
times the memory at up to 20 
times the access speed. And you 
can dash through virtually any 
software program with 
LiteDrive's™ full MS-DOS™ 
compatability. 

For those who admire sheer 
simplicity, the entire upgrade 
package is field installable in about 
30 minutes. Nightmares about 
motherboard modifications can be 
forgotten. Installation is a basic in 
and out operation accomplished 
with an everyday Phillips 
screwdriver. 


Forget About Head Crashes 

The worry of head crash has 
been minimized through the 
application of an automatic park 
function. Even in the most severe 
applications, this exceptional 
feature assures safe, reliable drive 
integrity by removing the head 
from the media area after 6 seconds 
of no access. And throughout even 
the most demanding conditions, the 
70g shock rating means the Z-171 
with LiteDrive™ is both rugged and 
durable. 

LiteDrive's™ most resounding 
feature is that it is capable of such 
peerless performance while remain¬ 
ing genuinely portable. 

Adds One Half Ounce to Z-171 

The entire hard disk unit adds a 
scant one half ounce to the Z-171, 
bringing the total weight to a 
compact 14.33 pounds. LiteDrive™ 
offers the added convenience of both 
battery and AC operation. 

The Premier Technologies' 
LiteDrive™ ... a breakthrough in 
price, practicality, and most of all 
... performance. 


Premier Technologies, Inc. 

1890 McGaw Avenue 


Irvine, CA 92714 

//##1 

714-261-2011 

// If '* 

Telex 678185 
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Classified Ads 


Hardware 

H89, 64K, H17, three drives, software, 
more. $450. 412/463-0068. 

H89, 64K; QS15, 15-megabyte hard disk; 
H77A dual floppies, dual Quikdata floppy 
drive; H25 printer with stand. All in ex¬ 
cellent condition and working order with 
software. $1,800. 504/876-7002. 

COMPUTER FOR SALE, used for de¬ 
velopment work. Zenith-100 dual 5V4 
floppy, green monitor, also dual 8" floppy. 
All manuals included. $2,500. Acron Cor¬ 
poration, 490 Oberlin Avenue South, 
Lakewood, NJ 08701. 201/364-7200. 
Attn. R. Wendt. 

Software 

Worksheets for Lotus 1-2-3 Tax Bill. TAX- 
BILL: an overview of the Senate tax bill 
including 1040 and “A” adjustments and 
tables. Not the whole bill but not expen¬ 
sive either. $35. It adjusts A.G.I., taxable 
and tax with the proposed “phase-out” 
rules, plus more. Will be quickly updated 
when the bill is passed. REAL ES¬ 
TATE: quick and easy analysis: opera¬ 
ting statements, cash-flow analysis, 
F. M. R. R. /M. I. R. R., transfer of Schedule 
“E” data to cash-flow analysis for past- 
performance analysis. $25. Introductory 
price @ NPV (both for $45). Phone 
orders with Visa, MasterCard. Roger 
Martin, C.C.I.M., P.O. Box 9099, 
Portland, OR 97207, 503/245-7441. 

MANDELBROT GRAPHICS FOR THE 
Z100. MANDL100 is the program for the 
serious explorer of the Mandelbrot set, or 


the serious programmer. Displays daz¬ 
zling images in 640x480 interlace mode, 
written entirely in assembly code for max¬ 
imum speed. Read in old pictures, or 
create new pictures by specifying number 
parameters or selecting areas of interest 
on screen. Save pictures in compressed 
format. Automatic or user-controlled 
color selection. Intrinsic screen blanker 
to prevent CRT damage. Complete 
source code including illustrating access¬ 
ing video RAM, file compression, reset¬ 
ting CRT-C chip for interlace mode, in¬ 
terlace character and string display. 
$19.95 from SAC ware, 12117 Old Colony 
Drive, Upper Marlboro, MD 20772. 
Requires Z100 with 64K color chips 
under MS-DOS 2. 

POWERFUL, FLEXIBLE, XY-PLOT- 
TING with LGRAPH. Featuring color 
graphics, log, linear scales, point 
symbols, multivariable plots, label and 
legend control, zoom mode, linear and 
nonlinear curvefits, built-in curve editor, 
more. Plots from disk and saves entries. 
For Z100, Z150, IBM-PC under Z-DOS, 
MS-DOS. Price $35. Free business, 
games programs with order. DMC, P.O. 
Box 1547, Kent, WA 98032. 

STILL SHIPPING 8-BIT PUBLIC 
DOMAIN software and directory. Direc¬ 
tory is $9 on double-sided double¬ 
density, $14 on single-sided, or $19 on 
hard-sectored; prepaid, domestic. Remit 
in US funds and add $2 for foreign 
shipments. Headware, 2865-S Akron, 
East Point, GA 30344. 

PRINTER CONTROL. “COM” pro¬ 
grams to control your printer from 


How to Order a Classified Ad 

To get in touch with your fellow 
Heath/Zenith users, place your 
short notice in Sextant’s classified 
section. The rate is only 750 per 
word, with a minimum of 15 
words. 

Please omit all specific 
references to software, unless the 
package is unopened. 

Send your typewritten ad and 
payment to: Sextant, Classified Ad 
Department, 716 E Street., S.E., 
Washington, DC 20003. Please in¬ 
clude your name and phone 
number for our records. 

Deadline is November 12 for the 
January-February 1987 issue, and 
January 21, 1987, for the March- 
April issue. 


keyboard. MS-DOS/CP/M versions. Tell 
me printer, operating system. $25. CUS¬ 
TOM PRINTER FONT(S) for printers 
that support “downloaded” characters. 
No program over $25. Visa and 
MC. Custom Computer Service, 503/ 
760-4690, 7466 S.E. 112th, Portland, OR 
97266. 

Information 

PERSONAL COMPUTER OWNERS 
can earn $1,000 to $5,000 monthly selling 
simple services performed by their com¬ 
puter. Work at home—in spare time. Get 
free list of 100 best services to offer. 
Write: C.I.L.D.H., P.O. Box 60369, San 
Diego, CA 92106-8369. 


We have an experience for you! 



Adventure gaming at its best. Each of 
our adventures has an overall plot and 
an underlying theme to truly make it an 
unforgettable experience. 

You must placate the caretaker to gain 
entrance to a cave of wonders! Fun, as well as 
educational, this game is for young people 
and adults alike. You'll enjoy its puns and riddles 
as you follow the ancient pirate's map to solve 
the mystery of the whistling maze. Feel your 
way through the elve's maze to discover the 
room of the agesl Find and collect treasures 
until you acquire all 550 points. 

All of our adventure games give you that 
exhilarating feeling, when you solve a sticky 


challenge. And if you really get stuck, 
and need clues, we're just a phone 
call or a post card away! 

Call and order now, and let the 
fun begin! 

iHoyle & Jioyle 

Software, Inc. 

111 Sparrow Drive 
Isle of Palms, SC 29451 
(803) 886-5802 

Available in HDOS, CP/M, MS-DOS. 
Z-DOS, PC-DOS for most systems. 
s 29.95 Visa, MC, Choice, COD, or 
check. Shipped within 24 hours. Write 
for further information about Remarkable 
Experience, and our other adventures. 
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NEWWORD " the better 

word processor from NewStar Software 


This fine word processor can be considered a clone 
of the popular WordStar program and it even uses 
the same commands. However, NewWord is 
faster, easy to customize, has the mail merge 
feature built-in, supports more printers, has an 
UNDELETE function and excellent documentation. 
It also includes the WORD Plus spelling checker by 
Oasis — an excellent product in itself! We offer this 
package at a discount. Just check the prices 
below. 

Available in most computer formats including 
Heath hard sector. 

30 Day Money-Back Guarantee! 


CP/M 80.$115 

MSDOS or CP/M 86. $195 

MSDOS delux version . $275 

Add $3 per order for shipping and handling. Terms: 
Check or Money Order — VISA/MC — COD. 
California residents add 6% tax. 


ANALYTICAL 
PRODUCTS 805/688-0826 

213 Teri Sue Lane Buellton, CA 93427 


FLEX1-GRAPH — version 2.0 

NOW ALSO SUPPORTS 

EGA 

AND 

TURTLE GRAPHICS 

Libraries based on TEKTRONIX and CORE graphics standards. Over 100 
routines provide a wide variety of high speed graphics capabilites. 

Callable from: 

MS-FORTRAN 
MS-PASCAL 
Many C Compilers 

(Includes source code for high level language interface routines) 

STILL SUPPORTS Z-100, Z-150 and IBM PC 

For Only $99 

(Plus $5 for Shipping & Handling) 

(Extensive Demo Disk—$3) 

NEW ORLEANS GENERAL DATA SERVICES, INC. 

7230 Chadbourne Drive 

» New Orleans, LA 70126 

(504) 241-9495 



INTELLIBURNER 

EPROM-EEPROM-MICROCOMPUTER PROGRAMMER 

UNIVERSAL PROGRAMMING CAPABILITIES 

AT AN AFFORDABLE PRICE 

• Ultra Fast Programming - 2716’s in 16 Seconds 

• Programs & Verifies 8K thru 256K Single Voltage EPROMs 

• Erases, Programs & Verifies 2815, 2816 & 2817 EEPROMs 

. Programs & Verifies 8748 and 8751 Series MICROCOMPUTERS* 

• Programming Characteristics Selected by Convenient 

Personality Jumper Plug (DIP Header) 

• Program, Verify, Status, & Diagnostic Display with Tricolor LED 

• Serial Interface — 3, 4, or 5 wire — 1200 to 19200 Baud 

. Supports ACK/NAK, XON/XOFF and READY/BUSY Protocols 

NO SPECIAL SOFTWARE REQUIRED. Transfer disk files (Intel Hex or Motorola’S’Format) 
to EPROM with your system’s line printer or modem software. Transfer EPROM contents 
to disk file with your system’s modem software. Or use the supplied software ** to transfer 
any binary or ASCII file to/from EPROM. 

PROGRAMS: 



CP/M systems on 8” SSSD - many 514 formats 
TRS-80 Model I & III TRSDOS - NEW! TRSDOS 6.X 
Heath H8/H89 HDOS & CP/M 
ZENITH Z90 & Z100 CP/M - Z100 ZDOS - Z150 
KAYPRO II/IV/10/16/286/2000 
IBM FC. PC/XT, AT - many MSDOS systems 
IntelliBurner Programmer with Software $ 299.00 

Stand-Alone RAM OPTION with 64K Bit RAM 
(Expandable to 256KBit) 89.00 

RS-232 Interconnect Cable 12.00 

IntelliBurner PC Boards, EPROM Plans & Software 99.00 

Low Cost “DumBumer” serial program¬ 
mers harness the power of your personal 
computer with the supplied software for full 
programming capabilities: 

DumBumer II Programmer for 28 Pin and 
24 Pin EPROMs and EEPROMs (with Software) $ 199.00 

DumBumer II Bare PC Board, Plans & Software 59.00 

16K/32K DumBumer for 24 Pin EPROMs (with Softw- re; 149.00 

16K/32K DumBumer PC Board, Plans & Software 39.00 


>USTOM FLECTRONICS 


1551 Sandra Drive 
Boulder City, Nevada 89005 
PHONE (702) 293-7426 


! ! NOW SHIPPING with ALL BURNERS ! ! 

TOOLKIT Software for Editing EPROM Information, 
Plus HEX/MOTOROLA 'S’/Binary File 
Conversion Utilities 

Ultra Violet Products EPROM Erasers 

Model DE-4 - Holds 8 EPROMS - Special Prices 


Add $3 Shipping & handling, ($2 Bare Boards), GO.D.’s accepted; Foreign Orders add required postage. Specify Enviri 
H8. H89, Z100 are “ Heath/Zenith; CP/M is ” Digital Research. TRS-80 is ™ Tandy Corp.; 1BM-PC, PC/XT, AT are 
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(Continued from page 7) 

times, this is quite a difference. 

3. A further marginal improvement may 
be effected by “unfolding” the loop. In¬ 
stead of incurring the overhead of the 
loop once per iteration, the code can be 
duplicated N times, and the test made 
only every Nth iteration. This means that 
FOR I = 0 TO 99: 

<evaluate Ith>: IF . . . THEN <exit> 

NEXT I 
becomes 

FOR I = 0 TO 99 STEP N 
<evaluate Ith>: IF . . . THEN <exit> 

<evaluate I + (N-l)th>: IF . . . THEN 1 = 1 + 
(N-2): <exit> 

NEXT I 

I use N = 8 in Mandel, and further, 
observing that large values of I occur 
rarely, make a transition for I above some 
threshold to a loop which makes several 
iterations before testing the results. This 
means that Mandel bunches the scores for 
large I, but since for large I the scores are 


sparse, this doesn’t affect the picture. 

4. A major efficiency improvement can be 
made when drawing pictures a large 
number of whose points are in the 
Mandelbrot Set, i.e., must be evaluated 
the maximum number of times. Mandel 
looks at the eight neighbors of a point to 
be evaluated, and if they all had the same 
score, assumes that the current point will 
not differ, and hence doesn’t bother to 
evaluate it. Since examination of the 
neighbors takes time, which will be addi¬ 
tional for points in a mixed neighbor¬ 
hood, this feature is useful only for 
pictures with large black areas. It can be 
optionally disabled. 

5. Finally, one can halve the time of 
operation by doing half the work. In 
Mandel, a Draft mode evaluates only 
every other point, using average values 
for intermediate ones. This allows fairly 
rapid generation of pictures; those deter¬ 
mined to be of interest can then be 
redone in Detail mode. 

I hope the above provides some stimu¬ 


lation for those who might want to expand 
on the ideas in the original article. The 
program mentioned, Mandel, together 
with a dozen or so sample pictures, run¬ 
ning on the Z100 multiprocessor only, is 
available from the undersigned for $25 for 
the object code, or $45 for object and 
ZBASIC source (check or money order 
only; deduct $5 with formatted disk and 
prepaid mailer) at 10 Thurston St., 
Somerville, MA 02145. 

Richard A. Tilden 
Software Toolsmith 
Somerville, MA 

Four drives vs. the emulators 

In my article [“Add More 5 1 // Drives to 
Your Z100,” in Sextant #23, July-August 
1986], I mentioned that my four-drive 
modification works without difficulty 
with the Gemini board in the Z100 mode, 
but not at all in the PC mode, since the 
Gemini hardware does not recognize 
more than two floppies. 

With the UCI EasyPC board in the 
Z100 mode, the same software changes in 
IO.SYS are required, but all drives will be 
48-t.p.i. The hardware change in the UCI 
controller that is equivalent to mine is 
simplicity itself. 

On page 13 (Appendix E) of the UCI 
EasyPC manual, there is a simple foil 
trace cut and a jumper to make all the 
drives 96-t.p.i. According to the UCI 
technical advisor, if the jumper on U39 is 
made to go from pin 6 of U39 to pin 2 of 
U19, the C and D drives become 96-t.p.i. 
This works flawlessly with the four-drive 
IO. SYS —but only in the Z100 mode. 

To make your C and D drives 96-t.p.i. 
in the PC mode, you have to patch the 
PC-DOS IO. SYS and FORMAT.COM accord¬ 
ing to the article by Daniel Ng, REMark , 
April 1986 [“Modifying the MS-DOS 
BIOS of the H-160 to Use a 96-tpi Disk 
Drive”]. Patching the IO. SYS has no effect 
except that you lose the ability to 
recognize the one-sided, nine-sector- 
per-track format. Be sure to make up a 
separate copy of FORMAT.COM, named 
FORMAT80.COM, since this patched ver¬ 
sion can only be used to format 96-t.p.i. 
disks in the C and D drives. If you wish, 
you can devise different ways of allocating 
sectors and clusters, but Ng’s works quite 
well. No hardware changes are necessary, 
other than the connecting ribbon cable 
with four edge connectors. Using Ng’s 
configuration, the PC 96-t.p.i. disks are 
not compatible with the Z100 formatted 
disks. Among other differences, Ng 
allocates one sector per cluster, while 
Zenith allocates four per cluster, and 
there are other non-compatibilities. 

UCI has some software available in 
their utility package that can give you 
your 96-t.p.i. drives, but you can’t beat 
the price of the one above. 

By the way, the help and support from 
UCI technical personnel has been ex¬ 
cellent—all via their toll-free number. 

William N. Tavolga 
Sarasota, FL 


Authors: 


Have you considered writing 
an article for Sextant.? We’re 
looking for human-interest 
stories, in-depth technical 
features, program descriptions, 
product reviews, and tutorials 
that relate specifically to 
Heath/Zenith machines — 
everything from the ’8 
to the ’248, and including 
the ’150. 

Send your article, idea, rough 
draft, or outline (no disks, 
please!) to: Charles Floto, 
Editor, Sextant, 716 E Street 
S.E, Washington, DC 20003■ 
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COMMUNICATIONS SOFTWARE CLASS 


HyperACCESS Leads its Class in Every Subject 


Even in the midst of communications, HyperACCESS 
lets you run your other DOS software or use your com' 
puter’s DOS commands. And HyperACCESS is so well- 
behaved, it can also run under Windows or Top View, 
concurrently with other programs. 

Conduct Your Own Examination 
Call or write Today! 

800-826-2760 or (313) 243-0576 


Whether you’re just beginning to use your PC for com' 
munications or you’ve been frustrated by limitations of 
another program, HyperACCESS is the answer. Simple 
for novices. Exhilarating for experts. Ideal for businesses. 

There’s no initial hurdle. HyperACCESS adapts itself to 
your computer and modem (it dials, redials, and answers 
more than 40 models). No steep learning curve. You can use 
it just by looking at your screen. The manual is crystal clear. 
An amazingly detailed training program is included. 

It comes ready to call CompuServe, Dow Jones, Easy Link, 
MCI Mail, NewsNet, The Source, and others (trial sub' 
scriptions included). Learns your passwords the first time 
you call and enters them for you from then on. You can 
list more than 100 computers (or people) for instant call' 
ing. HyperACCESS logs every call. 

Astonishing versatility! Lets you link with systems that defy 
others. With mainframes, minis, micros, or RS'232C 
devices. It emulates VT'52, VT' 100/102, TeleVideo 
925/950, IBM 3101, H'19, and TTY terminals. It supports 
up to 19,200 baud and transfers files FAST using Kermit, 
Xmodem (CRC or Checksum), and ASCII Protocols. 

HyperACCESS is an outstanding host, too. Even when 
you’re not there, your PC can be accessed by callers who 
have passwords you’ve defined. You set whether each caller 
can read or type messages, transfer files, run programs*, or 
use your PC without restrictions. 

HyperACCESS has the clearest, most complete script 
language, so you can create custom functions and menus, or 
automate any portion of a call. And we give you powerful 
scripts — transfer files between unattended PC’s — pick up 
electronic mail at 2 am — act as a high'Security dialback 
host, and more. 
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[ have a:_Z100 

_PC Compatible 

□ Send me a demo disk for $2 

□ Send me HyperACCESS for 

$149 

30-Day Money-Back Guarantee 
Not Copy Protected 


Name: 


Company Name: 
Shipping Address: 


Payment: □ Check □ VISA □ MC Card Exp. Date: 


Credit Card #: 


Add $5 shipping, $20 overseas; Michigan residents $6 sales tax. 

System Requirements: IBM PC, XT, AT, or compatibles. 192K RAM 
minimum. PC-DOS 2.0 or greater. (Separate Z-100 version.) 


Hilgraeve Inc., P.O. Box 941 Monroe, MI 48161 
Communications Software Since 1981. 


HyperACCESS, trademark of Hilgraeve; IBM, PC, XT, AT, TopView, trademarks of International Business Machines; MS, Windows, trademark of Microsoft; Crosstalk, 
trademark of MicroStuf; Smartcom, trademark of Hayes Microcomputer Products. *Certain programs are incompatible with remote use. 




























































From Gemini Technology 

50 % off 

Gemini Sound Boards 


That’s right ... if you’ve got a 
Gemini Emulator Board, or you know 
someone who does, we have a special 
holiday offer for you. Just 
write us or phone our 
toll-free number and 
give the name and full 
address of the person to 
whom we should send the new 
Gemini Sound Board, along with your 
cheque or Visa/MasterCard number and expiry 
date, and we ll deliver it in time for Christmas. You’ll pay only 
$ 14.95 — plus $3-00 for shipping — compared to the regular 

price of $29-95. 

Washington State residents please add 8.1% sales tax. 

This special Holiday offer 

is our way of saying thanks to the nearly 15,000 H/Z-100 users 
who have helped us become the recognized leader 
in IBM emulation technology. 

But don’t delay, the offer expires on 
December 12, 1986. 

BEST WISHES FOR A HAPPY HOLIDAY 
AND A PROSPEROUS NEW YEAR! 


GEMIIMI 

technology 


Gemini Technology Corp. 

13227 N.E. 20th Street 
Bellevue, Washington 
USA 98005 
1-800-663-8331 


*The Gemini Sound Board delivers sound support to Gemini Emulator equipped H/Z-lOO’s operating 
in IBM mode. H/Z -100 are trademarks of The Heath Company and Zenith Electronics Corporation 
respectively; IBM is a trademark of International Business Machines Corporation. Offer good while 
quantities last. 
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